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1. Language Summary 

The information provided in this handbook has been collected 
from multiple sources. It is intended to serve as a "keyboard- 
side" aid in the use of REXX under IBM's OS/2 2.x and OS/2 
Warp Versions 3 and 4. Items introduced with Warp Version 

3 are indicated by (V3). Items introduced with Warp Version 

4 (originally code named Merlin) are indicated by (V4). Items 
made obsolete by Warp Version 3 are indicated by (pre V3). 
Items available in Object REXX only are indicated by (OBJ). 

A complete reference for OS/2 SAA REXX (referred to as 
j Classic REXX) can be found in the OS/2 Information Folder 
and in the following IBM Publications: OS/2 Procedures 
Language 2 /REXX Reference (IBM publication number S10G- 
6268) and OS/2 Procedures Language 2/REXX User's Guide 
(IBM publication number S10G-6269). Beginning with Warp 
Version 4, the online REXX reference (REXX .INF) pertains 
to the active REXX interpreter with the alternate .INF file 
being renamed. If Classic REXX is active, the \OS2\BOOK 
directory will contain REXX.INF and OREXX.INF. If Object 
REXX is active, \OS2\BOOK will contain CREXX.INF and 
REXX.INF. 

Information for the use of the external REXX function 
packages included in this publication was obtained from the 
provider of the respective modules. Comments or questions 
regarding the use of these external REXX function packages 
should be directed to those sources. 

Numerous OS/2 utilities written in REXX by the author are 
available free of charge via anonymous FTP from 
ftp.cfsrexx.com/pub/ or with a Web browser on the World Wide 
Web at http://www.cfsrexx.com. 

The following syntax is be used throughout this publication: 
[item] 

Item is optional and is entered without the brackets, 
{ one | two} 

A selection of either one or two must be made. 
Default selections are underlined. 
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Alphabetic case, except within literal strings, is transparent 
unless otherwise noted. 

Lines which would normally appear as a single line but are 
split here because of the size constraint of the format of this 
publication appear as: 

Beginning of long line -» 

-+ remainder of long line 

° indicates leading zeroes are suppressed when a numeric 
value is returned. 

1.1 Basic Fundamentals and 
Structure 

A REXX program contains clauses built from combinations of 
the tokens defined below and terminated with a ";" 
(semicolon); however, the semicolon can be omitted at the 
end of a line as it is implied by the line end character(s) - 
normally a carriage return ('OD'x) and line feed ( ? 0A'x). 

Comments 

/* this is a comment */ 

Each REXX procedure / program, in the form of a 
.CMD file, must begin with a comment which starts in 
column 1 of line 1. 

Literal strings 

Characters enclosed in single ( ' ) or double ( " ) quotes. 
A trailing 'X' specifies hexadecimal notation. A trailing 
'B' specifies binary notation. Examples: 

'Hello!' "O'Leary's cow' 1 ' Ryan" s Express' 

»C1"x '1010'b 

Note: There is an implementation-defined limit of 250 
characters for a literal string. 

Symbols 

Composed of characters from the following group: 
a-z A-Z 0-9 . ! ? _ 

Any lower case alphabetic character in a symbol is 
translated to uppercase before use. 
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If a symbol begins with either a digit or a period, it can 
end with the sequence "E" (or "e") followed immediately 
by one or more digits. 

The purpose of a symbol varies depending on the 
context in which it is used. 

Note: Care must be used when converting REXX 
programs from otlier platforms to OS/2 since 
many of these other REXX interpreters permit 
other, non-SAA characters to be used. Of 
particular note are the characters x @\ x $\ and '#' 
which are not permitted in SAA REXX; however, 
Personal REXX for OS/2 will accept them. 

Variables 

Symbols whose value can be changed during the course 
of execution of a REXX program. Variables that have 
not been assigned a value (i.e. they are uninitialized) 
have a default value of the variable name in uppercase. 
Compound variables use a period ('.') to separate their 
component parts which include the stem (all characters 
up to, and including, the first period) and the tail (all 
characters following the first period). 

Labels 

Any single symbol followed by a colon. Labels identify 
the object of Call and Signal instructions and internal 



Numbers 

Integer, floating point or exponential notation. 
Examples: 

42 -22.78 3.14159625 1.68e+6 1.686E-6 

Operators and their precedence: 

+, * - ('AA'x) or \ 

prefix operators: plus, minus, not 



exponentiate (raise to a power) 

* / // % 

multiply (*), divide (/), divide and return only 
remainder (//), integer divide (%) 
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+ 

add, subtract 

(blank) || (abuttal) 

concatenate: with a blank, without a blank, withou 
blank 

= \= > < \> \< >= <= <> >< 

normal comparisons 

== \== » « \» \« »= «= 

strict comparisons 

& 

AND 

| && 

OR, exclusive OR 

(OBj; 

The tilde character is used in Object REXX as th< 
message send character. 

Expressions 

Any number of literal strings, variables, numbers o: 
function calls, separated by operators and parenthesis. 

Function calls 

return = functionjiame( [expression] - 

- [, [expression]]) 

or 

Call function_name [expression] [, [expression]] 

Invokes function jiame with expression passed & 
argument string(s). Up to 20 expressions are allowed 
When a function is explicitly called rather than usee 
as an expression, the special variable RESULT i 
assigned the function's return value as opposed tc 
return being assigned the value returned by the 
function. When a function call is used as ar 
expression (as in the first construct above), the lefl 
parenthesis must abut function name; however, z 
comment can be placed between function name and 
the left parenthesis. 
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Templates 

A list of symbols separated by blanks or patterns which 
include: 

variable name 

• the name of a variable to be assigned a value 

literal 

• used to match within the input string 

(variable name) 

• variable whose value is used to match the input 
string 

(period) 

• a placeholder that receives part of the input 
string, except that no assignment is actually 
performed 

integer 

• absolute character position in the input string 

= integer 

• same as preceding 

+ integer 

• relative position in the input string 

-integer 

• same as preceding 

= (variable name) 

• variable whose value specifies an absolute 
character position 

+ (variable name) 

• variable whose value specifies a relative character 
position 

-(variable name) 

• same as preceding 

In addition, a comma can be used in the template for 
PARSE ARG to indicate that the next argument 
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becomes the input string for the following portion of the 
template. 

1.2 Keyword Instructions 

expression 

Expression is evaluated and then passed as a commanc 
(i.e. passed to the external environment). The specia 
variable RC is set to the return code from the command 

variable = expression; 

Expression is evaluated and the result is assigned tc 
variable. There are 3 special variables (i.e. variables thai 
can be set automatically by the program) - RC 
RESULT and SIGL. Their use is shown where 
appropriate. 

ADDRESS [environment [expression]] 
ADDRESS [VALUE] expression 

Redirects the destination of all commands (or single 
command expression) to environment, or with VALUE tc 
have expression evaluated as the environment. 

The default value of environment for OS/2 is CMD 
(referring to CMD.EXE). The current value of 
environment can be retrieved with the ADDRESSQ 
function (page 16). 

ARG [template] 

Translates arguments from a function or subroutine call 
to uppercase and parses them according to the template 
(page 5). Short form of PARSE UPPER ARG. 

CALL name [expression] [, [expression]]... 

Calls the internal routine, built-in function, or external 
routine name, passing each expression as an argument. 
The special variable RESULT will be set by the called 
routine if an expression is present on the RETURN 
instruction. If no expression is returned by the called 
routine, RESULT will become uninitialized 
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CALL {ON | OFF} condition [NAME label] 

Activates or deactivates the user-defined condition 
related handlers. Control transfers to the label matching 
condition by a CALL instruction if the condition occurs 
while the trap is ON. Label can specify an alternative 
label name. 

Condition can be 'ERROR', 'FAILURE', 'HALT', 
'NOTREADY'. 

DO [repetitor] [conditional] 

[instruct! on_l ist] 
END [con trol_vari able] 

Groups instructions together and optionally repeats 
them, where repetitor is one of: 

name = expr [TO expr] [BY expr] [FOR expr] 

FOREVER 

expr 

conditional is either of: 
WHILE expr 
UNTIL expr 

instruction Jist is any sequence of instructions; expr 
evaluates to a number; and control _va liable is the name 
of the respective control variable used in the repetitor. 

DROP name [name] . . . 

Drops (resets to uninitialized state) the variable(s). If 
name is enclosed in parentheses, it is treated as a list of 
names and variables to drop. If name is a stem, then all 
variables of that stem are dropped. 
Example: a = 'x y z' 

drop (a) /* drops a, x # y, & z */ 

EXIT [expression] 

Leaves the program, returning expression to the caller. 
Expression can be any value; however, some programs 
which call REXX programs cannot process a return 
value unless expression evaluates to a signed integer in 
the range (-2 15 to 2 15 -1). CMD.EXE is an example of a 
calling program subject to this restriction. 
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IF expression^] THEN[;] instruction 
[ELSE[;] instruction] 

Expression must evaluate to either 0 or 1. If express^ 
evaluates to T, the instruction following the THEN i 
executed; otherwise, the instruction following the ELS1 
is executed. Instruction may be a group of instruction 
bounded by a DO / END pair. 

INTERPRET expression 

Evaluates expression and then executes it as a 
instruction. 

ITERATE [repetitor] 

Starts the next iteration of the innermost or specifie 
repetitive DO loop as if the END instruction had bee 
reached. A particular DO loop is identified by ii 
repetitor. 

LEAVE [repetitor] 

Leaves the innermost or specified repetitive DO loop, i 
particular DO loop is identified by its repetitor. 

NOP 

A dummy instruction; does nothing. It is frequently use 
as the target of a THEN or ELSE clause. 

NUMERIC DIGITS [9 | expression] 

Specifies arithmetic precision to expression significai 
digits - default is 9. 

NUMERIC FORM [ SCIENTIFIC | ENGINEERING] 
NUMERIC FORM [VALUE] expression 

Specifies the form of exponential numbers. The FORI 
is set directly by the sub-keywords SCIENTIFIC c 
ENGINEERING or by evaluating expression. 

NUMERIC FUZZ [expression] 

Specifies that expression digits, at full precision, are to t 
ignored during numeric comparisons. 
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OPTIONS expression 

Expression is evaluated for [{ETMODE | 
NOETMQDE}] [{EXMODE | NOEXMODE}] to 
control double-byte character set (DBCS) interpretation. 
These settings are not applicable to Personal REXX. 

PARSE [UPPER] ARG [template] 

Parses the arguments according to template (page b) 
from a function or subroutine call, optionally first 
translating them to uppercase. 

PARSE [UPPER] LINEIN [template] 

Parses the input from the default character input stream 
according to template (page 5), optionally first translating 
it to uppercase. 

PARSE [UPPER] PULL [template] 

Parses the next line in the REXX data queue according 
to template (page 5), optionally first translating it to 
uppercase. If the queue is empty, lines will be read from 
the standard input stream (normally the keyboard). 

PARSE [UPPER] SOURCE [template] 

Parses the program's source information (3 tokens) 
according to template (page 5), optionally first translating 
it to uppercase. 

Example: OS/2 COMMAND C:\0S2\REXXTRY.CMD 
OS/2 SUBROUTINE D:\0S2\rexxtry.CMD 

I Note: If issued within a subroutine, the information 

\ reflects the parent 

PARSE [UPPER] VALUE [expression] WITH [template] 

Parses the value of expression according to template 
(page 5), optionally first translating it to uppercase. 

PARSE [UPPER] VAR name [template] 

Parses the value of name according to template (page 5), 
optionally first translating it to uppercase. 
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PARSE [UPPER] VERSION [template] 

Parses the information describing the language processor 
and level followed by its date, according to template 
(page 5), optionally first translating it to uppercase. 
Example: 

REXXSAA 4.00 08 Jut 1992 

REXXSAA 4.00 10 Feb 1994 <V3) 

REXXSAA 4.00 24 Aug 1996 <V4) 

OBJREXX 6.00 12 Jul 1996 (OBJ) 

REXX/Personat 4.00 12 Oct 1994 

PROCEDURE [EXPOSE name [name]...] 

Provides a mechanism to protect local variables within 
an internal routine, and optionally specifies global 
variables to be exposed (unprotected). If name is 
enclosed in parentheses, it is treated as a list of names 
of variables to expose. 
Examples: a = 'x y z' 

label: PROCEDURE EXPOSE (a) /* will 

result in x, y, & z being exposed */ 

label: PROCEDURE EXPOSE b. /* will 

result in all variables with a stem 
of b. being exposed */ 

PULL [template] 

Translates the next line in the currently active REXX 
data queue to uppercase and parses it according to 
template (page 5). If the queue is empty, a line will be 
read from the standard input stream (normally the 
keyboard). Short form of PARSE UPPER PULL. 

PUSH [expression] 

Places the value of expression at the top (/LIFO) of the 
currently active REXX data queue. If expression is 
omitted, a null string is stacked. 

QUEUE [expression] 

Places the value of expression at the bottom (/FIFO) of 
the currently active REXX data queue. If expression is 
omitted, a null string is stacked. 

RETURN [expression] 

Returns control, and optionally a value - expression, to 
the caller of the routine or program. 
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Return to a subroutine (from CALL) causes expression 
to be evaluated and placed in the special variable 
RESULT. If expression is omitted, RESULT is 
uninitialized (i.e. DROPped). 

Return to a function invocation requires expression to be 
specified and that value is then used in the original 
expression where the function evaluation was invoked. 

If a RETURN instruction is executed within a routine 
that was not invoked by either a CALL instruction or 
function invocation, RETURN functions like the EXIT 
instruction. 

SAY [expression] 

Displays the value of expression, appended with a 
carriage return / line feed character pair ('ODOA'x), on 
STDOUT (which can be redirected). 

SELECT 

WHEN expression^] THEN[;] 

instruction 
[WHEN expression^] THEN[;] 

instruction].,. 
[OTHERWISE [;] 

[instruction] . . .] 

END 

Selects and executes the first expression that evaluates to 
a T and executes its corresponding instruction. 
Instruction may be a group of instructions bounded by a 
DO / END pair. 

If none of the expressions evaluates to a T, then the 
instructions following the OTHERWISE (which should 
always be there) are executed. 

SIGNAL label jiame 

SIGNAL [VALUE] expression 

Transfers control to the instruction labeled label name; 
or evaluates expression and transfers control to the 
instruction labeled with that value. 

When control reaches the specified label, the line 
number of the SIGNAL instruction is assigned to the 
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special variable SIGL. This can aid debugging becau 
the SIGL value can be used to determine the source 
a jump to a label. 

SIGNAL {ON | OFF} condition [NAME label] 

Activates or deactivates the condition handler. Conti 
transfers to the label matching condition by a SIGN/ 
instruction if the condition occurs while trap is ON. 



Label can specify an alternative label name. Conditi 
can be: 

ERROR An external command returned a nc 
zero return code that either did not resi 
in a FAILURE condition or that result 
in a FAILURE condition but a SIGN/ 
ON FAILURE was not active. 



FAILURE An external command failed and result 
in a return code being passed back to t 
parent program. 

HALT Results from a < Ctrl-Break > interrupt! 

or some other manual action that cau* 
the program flow to be interrupted. 

NOTREADY Results from a reference to 
external I/O device that is not rea< 



NO VALUE Results from referencing a variable tr 
has not been initialized (not assigned 
value). 

SYNTAX Results from an incorrect construct 
reference to an external function w: 
invalid parameters. 

When control reaches the specified label, the li 
number of the SIGNAL instruction is assigned to t 
special variable SIGL. This can aid debugging becai: 
the SIGL value can be used to determine the source 
a jump to a label. 
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TRACE [[?] {A | C | E | F | I | L | N | 0 | R}] 
TRACE [VALUE] expression 

Controls tracing of program execution (null restores the 
default). Trace output is written to STDERR. 

Trace output can be redirected to filejiame by 
appending 2> file__name to the command which invokes 
the REXX program. 

VALUE evaluates expression as the trace setting. 

? turns interactive debugging on and off (pause after 
each instruction), with trace output controlled by 
the next character. If STDERR is redirected, tracing 
continues uninterrupted by the pause, effectively 
ignoring the ? option. 

A (All) traces all clauses. 

C (Commands) traces all commands. 

E (Error) traces commands with non-zero return 
codes. 

F (Failure) traces a host command that fails, also 

indicates the return code. 
I (Intermediates) traces intermediate expression 

evaluation, results and name substitution. 
L (Labels) traces labels. 

N (Normal) only host commands, after a failed 

execution. This is the default setting. 
O (Off) Resets tracing to off. 

R (Results) traces all clauses and expressions are 
traced before execution. 

All trace output is prefixed by three characters which 
identify the type of trace output line: 

*-* Identifies the source of a single clause (i.e. the 
actual program data). 

+ + + Identifies a trace message. This can be the non- 
zero return code from a command, the prompt 
message when interactive tracing begins, or the 
traceback clauses after a syntax error in the 
program. 
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> > > Identifies the result of an expression (for TRAC 

R), the value assigned to a variable during parsir 
or the value returned from a subroutine call. 

>.> Identifies the value "assigned" to a placehold 
during parsing. 

The following prefixes are only used if TRAC 
Intermediates is in effect: 

>C> The name of a variable (after substitution). 
>F> The result of a function call. 
>L> A literal. 

>0> The result of an operation on two terms. 
>P> The result of a prefix operation. 

> V> The contents of a variable. 

Note: The TRACE instruction should not be confus* 
with the TRACEQ built-in function (page 32) 

13 System Commands & 

Subcommand Environments 

RXQUEUE [option] [queue jiame] 

Causes the data which follows it on STDIN (norma 
the keyboard, but can be the redirected output of 
command) to be placed in queue jiame or in the defai 
REXX data queue SESSION if queue jiame is omitte 

Option may be: 

/CLEAR The contents of the currently select 
REXX data queue is cleared. 

/FIFO Data will be placed in the queue in a "first 
first out" manner. The oldest line in the que 
will be the first to be retrieved. 
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/LIFO Data will be placed in the queue in a "last in, 
first out" manner. The newest line in the queue 
will be the first to be retrieved. 

If the source of the data is the keyboard, the data must 
be terminated with an end of file character, <Ctrl-z> 
(lA'x). 

The default queue name can be altered by use of the 
OS/2 environment variable RXQUEUE. 
Example: SET RXQUEUE=queue_name 

The combined STDOUT and STDERR output can be 
redirected or "piped" to the a REXX data queue. 
Example: DIR *.XYZ 2>&1 j RXQUEUE 

Note: The RXQUEUE subcommand should not be 
confused with the RXQUEUEQ built-in function 
(page 27). 

RXSUBCOM DROP envjiame [dlljiame] 
RXSUBCOM LOAD envjiame [dlljiame] 
RXSUBCOM QUERY envjiame [dlljiame] 
RXSUBCOM REGISTER envjiame dlljiame entry j)oint 

Drops, loads, queries or registers subroutines in 
envjiame. Dlljiame is the name of the Dynamic Link 
Library module name. Entry _point is the name of the 
function to be executed when called. 

Returns 0 if the function completed successfully; 
otherwise, returns -1 if the parameters are incorrect or: 

10 Envjiame is a duplicate (REGISTER). 
30 The envjiame is currently in use (REGISTER) or 
does not exist (QUERY, DROP). 

SET RXTRACE= "ON | OFF 

The RXTRACE environment variable can be set to ON 
prior to starting the REXX interpreter. This will result 
in the interpreter starting as if the instruction 
TRACE '?R' was the first instruction in the REXX 
program that is being run. However, if STDERR is 
redirected when the interpreter is started, 
RXTRACE = ON has same effect as if TRACE R was 
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the first instruction in the REXX program (i.e. tracin 
will not be interactive). 

RXTRACE=ON can be reversed with either of th 
following command line statements: 

SET RXTRACE= 
SET RXTRACE=OFF 

1.4 Built-in Functions 

OS/2 REXX contains 76 built-in functions that are availabl 
without the need to load external function packages (APIs). 

ABBREV( full_string, test_string[, length] ) 

Returns 1 if testjtring is equal to the leading charactei 
of full_string and the length of testjtring is at least lengt, 
long; otherwise, returns 0. 

Example: 1 = ABBREVC 'ABCDEF', 'ABD', 2 ) 
0 = ABBREVC 'ABCDEF', 'ABD', 3 ) 

ABS( number ) 

Returns the absolute value of number as an unsigne 
value formatted according to the current NUMERL 
setting. ° 

Example: 128 = ABS( -128 ) 
128 = ABS( 128 ) 
128 = ABS< 1.28e2 ) 

ADDRESS () 

Returns the name of the current environment to whic 
host commands are submitted. See the ADDRES 
instruction on page 6. 
Example: CMD 

ARG( [n[, option]] ) 

Returns the number of arguments, or the wth argumei 
if n is specified. If option is E (exists), returns 1 if n\ 
argument exists; otherwise, returns 0. If option is < 
(omitted), returns 1 if nth argument was omitte< 
otherwise, returns 0. 

Note: Regardless of the number of words, or format t 
a command line value passed to a REX 
program, this function will always indicate 
single argument for the command line string. 
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B2X( binary_string ) 

Binary to hexadecimal. Returns the hexadecimal 
equivalent of binary jtring (digits 0 and 1). Blanks can be 
imbedded within binary jtring, si four-digit boundaries 
only, for readability. The returned string will use 
uppercase alphabetic characters for A-F and will not 
contain any blanks. 
Example: C3 = B2XC 1100 0011 ) 

BEEP( frequency, duration ) 

Sounds the computer's speaker. Frequency, in cycles per 
second (Hertz) with a range of 37 to 32,767, is rounded 
to the nearest integer. Duration is in milliseconds with a 
range from 1 to 60,000. Functionally equivalent to 
SOUND() (page 95). 

BITAND ( stringl[, [string2][, pad]] ) 

Returns a string composed of the two input strings 
stringl and string2 logically AND'ed together, bit by bit, 
with the shorter string optionally padded with pad. 
Example: '01 'b = BITANDC '01 'b, Ml 'b ) 
'C3'x = BITANDC M7'x, 'c3'x ) 

BIT0R( stringl[, [string2][, pad]] ) 

Returns a string composed of the two input strings 
stringl and stringl logically OR'ed together, bit by bit, 
with the shorter string optionally padded with pad. 
Example: M1'b = BITORC. '01'b, M1'b ) 
' F7'x = BITORC 'f7'x, 'c3'x ) 

BITX0R( stringl [, [string2] [, pad]] ) 

Returns a string composed of the two input strings 
stringl and stringl logically XOR'ed together, bit by bit, 
with the Shorter string optionally padded with pad. 
Example: MO'b = BITXORC # 01'b, M1'b ) 
'34'x = BITXORC M7'x, 'c3'x ) 

C2D( string [» n] ) 

Character to decimal. Returns the decimal value of the 
binary representation of string. If n is specified, string is 
taken as a signed number expressed in n characters. 
Example: 65 = C2DC 'A' ) 
97 = C2DC 'a' ) 
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C2X( string ) 

Character to hexadecimal. Converts (unpacks) th 
character string string to its hexadecimal representatioi 
The returned string will use uppercase alphabet] 
characters for A-F and will not contain any blanks. 
Example: '41' = C2X( 'A' ) 
'61' = C2X< 'a' ) 

CENTER ( string, length [, pad] ) 
CENTRE ( string, length[, pad] ) 

Returns a string of length with string centered in i 
optionally padded with pad (defaults to blank) c 
truncated as needed. Odd number truncation is applie 
to the right side. 

CHARINf [name][, [start] [, length]] ) 

Returns a string up to length (default 1) characters rea 
from the character input stream name, optional! 
beginning at start (default 1). Can raise th 
NOTREADY condition. 

Files are implicitly opened with the first invocation c 
CHARIN for the file. Files should be explicitly closei 
with the close option of the STREAMQ function (pag 

29). 

CHAR0UT( [name], [string] [, start] ) 

Returns the count of characters remaining afte 
attempting to write string to the character output strean 
name. 

If only name is specified, the file name is closed. 

Start optionally specifies name x % write pointer an< 
defaults to the current write position. Can raise th< 
NOTREADY condition. 

Files are implicitly opened with the first invocation o 
CHAROUT for the file. Files should be explicitly close* 
with the close option of the STREAM() function (pag< 
29). 
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CHARS ( [name] ) 

Returns the total number of characters remaining in the 
character input stream name; otherwise, returns 0. If 
name is omitted, STDIN is assumed 

For streams where the number of characters remaining 
cannot be determined, returns 1 if any characters 
remain; otherwise, returns 0. Can raise the NOTREADY 
condition. 

Files are implicitly opened with the first invocation of 
CHARS for the file. Files should be explicitly closed 
with the close option of the STREAMQ function (page 
29). 

COMPARE ( stringl, string2[, pad] ) 

Returns 0 if stringl and string2 are identical; otherwise, 
returns the position of the first character that does not 
match. The shorter string is padded on the right with 
pad, which defaults to a blank, if necessary. 

CONDITION ( [option] ) 

Returns a word from the list shown below (option C, I, 
or S), or a descriptive string (option D) associated with 
the current trapped condition indicated by option. 
Option can be C (condition), D (description), I 
(instruction) , or S (status). Possible combination of 
values (one from each column) returned for all options 
but D are: 

Returns: If: C I_ S 

CALL 
DELAY 
ERROR 
FAILURE 
HALT 
NOVALUE 
NOTREADY 
OFF 
ON 

SIGNAL 
SYNTAX 

In the instance of this function being issued following a 
NOVALUE trap for condition D, the value returned is 
the uninitialized variable. 
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C0PIES( string, n ) 

Returns n concatenated copies of string. 
Example: 'abcabc' = COPIES( 'abc', 2 ) 

D2C( wholeji umber [ f n] ) 

Decimal to character. Returns a string, with a length \ 
needed, or a length of n, containing the ASC 
representation of whole jiumber. If n is specified, 
represents the character length of the returned string. 
Example: 'A' = D2C( 65 ) 
'a' = D2CC 97 ) 

D2X( who1e_number[, n] ) 

Decimal to hexadecimal. Returns a string, with a lengl 
as needed, or a length of n, containing the hexadecim; 
characters equal to whole jiumber. If n is specified, 
represents the character length of the returned strini 
The returned string will use uppercase alphabet: 
characters for A-F and will not contain any blanks. 
Example: '41' = D2X( 65 ) 
'61' = D2X< 97 ) 

DATATYPE ( string [, type] ) 

If only string is specified, the returned result is 'NUM' 
string is a valid REXX number otherwise 'CHAR' : 
returned. 

Returns 1 if string is of the type type; otherwise, renin 
0. Type can be: 

A alphanumeric - a-z, A-Z, 0-9 
B binary - 0 & 1 

C mixed SBCS (single-byte character set) / DBC 

(double-byte character set) 
D pure DBCS 
L lowercase - a-z 
M mixed case - a-z & A-Z 
N valid REXX number 

S any character which is permitted in a REXX symbc 

(page 2) 
U uppercase - A-Z 

W REXX whole number according to DIGITS settin: 
X hexadecimal - a-f, A-F, 0-9 & blank 
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DATE( [option] ) 

Returns the local date in the format: dd Mon yyyy°, or 
in the format specified by option: 

B (Basedate) dddddd - days since & including 

Jan. 1, 0001. ° 

C (Days this century) ddddd. (Personal REXX only) 

D (Days this year) ddd. ° 

E (European) dd/mm/yy. 

J (Julian) yyddd. (Personal REXX only) 

L (Local or implementation defined) dd Month yyyy. 

M (Month) Full English name of the current month. 

N (Normal) default format, dd Mon yyyy ° 

O (Ordered) yy/mm/dd. 

S (Sorted) yyyy mm dd. 

U (USA) mm/ddfyy. 

W (Weekday) Weekday name in English in mixed case 
(first letter uppercase). 

DELSTR( string, n[, length] ) 

Deletes the sub-string of string that begins at the nth 
character and is of length length. If length is not 
specified, the rest of the string is deleted (including the 
nth character). 

Example: 'abe' = DELSTRC 'abcde, 3, 2 ) 

DELW0RD( string, n[, length ) 

Deletes the sub-string of string that begins at the nth 
word. Length indicates the number of blank delimited 
words. If length is not specified, the remaining words are 
deleted. 

Example: 'ab cd' = DELWORDC 'ab cd ef gh\ 3 ) 
DIGITS () 

Returns the current setting of NUMERIC DIGITS. ° 

DI RECTORY ( [new J i rectory] ) 

Returns the result of changing the current directory to 
newjiirectory, if it is specified and newjiirectory exists. 
DIRECTORY() must be used without newjiirectory if 
the value of the current directory is needed. 

Note: Use of the DIRECTORYQ function is preferred 
over the external 'CD 1 command to change the 
current directory since the external CD command 
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requires shelling out to CMD.EXE and, if the 
REXX program is not running under CMD.EXE 
(e.g. PMREXX), then the directory change is lost. 

ENDLOCALQ 

Restores the drive, directory and environment variables 
in effect before the last SETLOCAL function. Returns 
1 if environment successfully restored; otherwise, returns 
0. 

ERR0RTEXT( n ) 

Returns the text of the error message associated with 
error number n (0 £ n £ 99). Undefined error numbers 
return a null string. Appendix D (page 215) lists all of 
the error messages and their meaning. 
Example: 'File Table full' = ERRORTEXT< 1 ) 

FILESPEC( option, filespec ) 

Parses the complete file name in filespec and returns the 
selected element of filespec as indicated by option or 
returns a null string if the requested token is not found. 
Filespec need not be an existing file. Similar in function 
to PARSEFN (page 87). Example of returned string 
given the file system name of C:\OS2\DLL\REXX.DLL 
for option: 

D (Drive) 'C:' 

P (Path) '\0S2\DLLV 

N (Name) 'REXX. DLL' 

FORMQ 

Returns the current setting of NUMERIC FORM (i.e. 
SCIENTIFIC or ENGINEERING). 

FORMAT ( number[, [before] [, [after] - 

- [ ,expp][ ,expt]]]] ) 

Returns number rounded and formatted with before and 
after specifying the size of the integer and fraction parts 
respectively. Expp specifies the number of places for the 
exponent and expt specifies the trigger point for the use 
of exponential notation. If before is not large enough to 
contain the integer part of number an error results. 
Example: with x = 123.456 

123.45 = FORMAT ( x, 3, 2 ) 

123E+2 = FORMAT ( x, 3 f 2, 1, 1 > 
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FUZZ() 

Returns the current setting of NUMERIC FUZZ 
(default is 0). ° 

INSERT ( new, targetf, [n] [, [length] [, pad]]] ) 

Inserts the string new, padded to length with pad, into 
the string target after the nth character. Default value of 
n is zero and default value of pad is blank. Use of the 
defaults is equivalent to specifying new \ \ target 
Example: 

'ab?cd' = INSERT< '?', 'abed', 2 ) 

LASTP0S( needle, haystack [, start] ) 

Returns the character position of the last occurrence of 
needle in haystack, otherwise, returns 0. The search is 
started at the last character of haystack, or start, and 
proceeds right to left. 
Example: 5 = USTP0S( 1, 121314 ) 

LEFT( string, length [, pad] ) 

Returns a string of length length containing the left-most 
length characters of string, padded with pad or truncated 
on the right as needed. 
Example: 'abc' = LEFT( 'abedef , 3 ) 

LENGTH ( string ) 

Returns the length of string. ° 

LINEIN( [name] [, line][, count]] ) 

Returns count line(s) read from the character input 
stream name. Count can be either 1 - read one line, or 
0 - reposition the read pointer. Line (which must be 1 if 
used) specifies the line position in the stream from 
which to read. Can raise the NOTREADY condition. 

Files are implicitly opened with the first invocation of 
LINEIN for the file. Files should be explicitly closed 
with the close option of the STREAM () function (page 
29). 
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LINE0UT( [name][, string] [, line]] ) 

Returns the count of lines remaining (0 - none, 1 - 
otherwise) after attempting to write string to the 
character output stream name. Line (which must be 1 if 
used) specifies the line position in the stream at which 
to write. Can raise the NOTREADY condition. 

If only name is specified, the file name is closed. 

Files are implicitly opened with the first invocation of 
LINEOUT for the file. Files should be explicitly closed 
with the close option of the STREAM () function (page 
29). 

LINES ( [name] ) 

Returns 1 if any lines remain in the character inpul 
stream name, otherwise, returns 0. Can raise the 
NOTREADY condition. 

Files are implicitly opened with the first invocation o: 
LINES for the file. Files should be explicitly closed wit! 
the close option of the STREAM () function (page 29). 

MAX( number [, number] ... ) 

Returns the largest number out of the list specified. ° 

MIN( number [, number] ... ) 

Returns the smallest number out of the list specified. ° 

0VERLAY( new, target[, [n] [, length] [, pad]]] ) 

Returns the string target, which, starting at the ntl 
character, is overlaid with the string new, padded wit] 
pad or truncated to length. 

Example: 'ab?de' = OVERLAY ( '?' , 'abcde', 3 ) 

P0S( needle, haystack[, start] ) 

Returns the character position of the first occurrence c 
needle in haystack; otherwise, returns 0. The search i 
started at the first character of haystack, or start, an 
proceeds left to right. ° 
Example: 2 = P0S( 2, 121212 ) 
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QUEUED () 

Returns the number of lines remaining in the currently 
active REXX data queue. 0 The name of the currently 
active REXX data queue can be interrogated or set with 
the RXQUEUE() function (page 27). 

RANDOM ( max ) 

RANDOM ( [min][ t max][, seed] ) 

Returns a quasi-random, non-negative, whole number in 
t^ie range 0 to 999, or min to max inclusive. Max minus 
min must not exceed 100,000. A whole number, seed, can 
be specified if repeatable results are desired. ° 

REVERSE ( string ) 

Returns string, swapped end for end. 
Example: 'edcba' = REVERSEC 'abcde' ) 

RIGHT ( string, length [, pad] ) 

Returns a string of length length containing the right- 
most length characters of string, padded with pad or 
truncated on the left as needed. 
Example: 'de' = RIGHTC 'abcde', 2 ) 

RXFUNCADD( function jiame, module, entry jiame ) 

Returns 0 if the external function function jiame located 
in module with an entry point name entry jiame is 
successfully registered (added as being available); 
otherwise, returns an error code identifying the error. 

A return code of 0 does not indicate that the module 
(i.e. DLL) and entry name actually exist. 

Note: Entry jiame is case sensitive and both 
function jiame and entry jiame should be 
specified as either literals or assigned variables. 

RXFUNCDR0P( function jiame ) 

Returns 0 if function jiame is successfully removed 
(unregistered); otherwise, returns 1. When 
function jiame is removed, it becomes unavailable to this 
session and all other sessions until a subsequent 
RxFuncAdd() restores its availability. Thus, the 
RXFUNCDROP function should be avoided in normal 
operation. 
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RXFUNCQUERY( functionjiame ) 

Returns 0 if functionjiame is registered (available for 
use); otherwise, returns 1. 

RXMESSAGEBOX( text[ f title] [, button] [, icon] ) 

Returns a whole number resulting from a button which 
was selected in a text box created with this function call 
and containing text, with the optional title. 

This function is only available to a REXX program 
running under PMREXX or called from a Presentation 
Manager application. It can also be used with a program 
launched from the command line with the following: 

START /PM CMD /C progranwiame [parameters] 

An optional button and icon can also be included in the 
text box. The style of button, which defaults to OK, 
includes: 

OK 

A single OK button. 
OKCANCEL 

Both an OK button and a Cancel button. 
CANCEL 

A single Cancel button. 
ENTER 

A single Enter button. 
ENTERCANCEL 

An Enter button and a Cancel button. 
RETRYCANCEL 

A Retry button and a Cancel button. 
ABORTRETRYCANCEL 

An Abort button, a Retry button and a Cancel 

button. 
YESNO 

A Yes button and a No button. 
YESNOCANCEL 

A Yes button, a No button and a Cancel button. 

Icon designates an optional icon to be displayed in the 
text box. Icon can be: 

NONE 

No icon is displayed. 
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HAND 

The hand icon is displayed. 
QUESTION 

A question mark icon is displayed. 
EXCLAMATION 

An exclamation icon is displayed. 
ASTERISK 

An asterisk icon is displayed. 
INFORMATION 

The information icon, identical to the icon shown on 
the desktop, is displayed. 
QUERY 

The query icon is displayed. 

The whole number returned, as a result of the button 
being selected, will be: 



1 OK button 5 Ignore button 

2 Cancel button 6 Yes button 

3 Abort button 7 No button 

4 Retry button 8 Enter key 

Note: The dialogue box with the text "The REXX 
procedure has ended" which appears at the 
completion of all programs run with PMREXX 
can not be suppressed. It is compiled into the 
PMREXX program. 

RXQUEUE( CREATE [, queue jiame] ) 
RXQUEUE( DELETE, queue jiame ) 
RXQUEUE( GET ) 

RXQUEUE( SET, newjjueue jiame ) 

Create returns the name of the newly created REXX 
data queue - either queuename or a system generated 
name if queue name is omitted or a queue named 
queue jiame already exists. 
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Delete returns the following after attempting to delete 
queue name'. 

0 Que has been deleted. 

5 Not a valid queue name. 

9 Queue name does not exist. 

10 Queue is busy; wait is active. 
12 A memory failure occurred. 

1000 Initialization error; check OS2.INI 

Get returns the name of the queue currently in use ir 
this session. 

Set returns the name of the queue currently in use ir 
this session and replaces the current queue with 
new_queue_name . 

The RXQUEUE() function should not be confused witr 
the RXQUEUE subcommand (RXQUEUE.EXE - page 
14) 

SETL0CALO 

Returns 1 if the current working drive and directory, am 
the current values of the OS/2 environment, an 
successfully saved by the SETLOCAL function 
otherwise, returns 0. 

SIGN( number ) 

Returns a number that indicates the sign of number ('-1' 
■0 r ,orT). 

S0URCELINE( [n] ) 

Returns the nth line of the program, or the number o 
lines in the program if n is omitted. Returns 0 if n i: 
omitted, or a null string if n is specified when the source 
program is not available (e.g. the program is being rui 
from the macrospace). 

SPACE ( string [, [n] [, pad]] ) 

Returns a formatted string of the blank-delimited word; 
in string with n pad characters between each word. 
Example: 'abc def ghi' = SPACEC 'abc def ghi' 
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STREAM ( filejiame[, operation[, stream_command]] ) 

Returns information describing the state of the character 
stream filejmme or the result of an operation on 
filejmme. Operation can be: 

C (Command) 

D (Description) 

S (State) 

If operation is C, stream command can be: 

OPEN {READ | WRITE} 

Opens filejmme for both reading and writing 
unless READ or WRITE is specified (WRITE 
implies READ access). If neither is specified, 
both are implied. 

CLOSE 

Closes filejmme. Returns "READY:" if close is 
successful otherwise an appropriate error 
indication. Returns a null string if filejmme 
was not previously OPENed. This option is the 
preferred method for closing a file vs. using 
one of the I/O functions with just the filejmme 
parameter. 

SEEK iz | < | + I -} offset 

Sets the read / write position of the previously 
OPENed filejmme to a value specified by 
offset. Offset can only represent a number of 
characters. Therefore, the position of a line 
within a file is implied only if the file contains 
fixed-length records thus allowing the number 
of characters to be calculated. 

Returns the new position in the file if the 
operation was successful; otherwise, returns an 
error indicator. 

The offset number can be preceded by: 

= Explicitly specifies the offset from the 

beginning of the stream. 
< Specifies the offset from the end of the 

stream. 
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+ Specifies the offset forward from the 
current position. 

Specifies the offset backward from the 
current position. 

QUERY [EXISTS | SIZE | OATETIME] 

EXISTS Returns the full path of filejiame or 
a null string if filejiame does not 
exist. 

Example: D:\os2\dll\rexx.dll 

SIZE Returns the size, in bytes, of 
filejiame. ° 
Example: 248352 

DATETIME Returns the date and time 
stamps of file jiame. 
Example: 09-29-93 17:46:42 

If operation is C, STREAM returns READY: if 
stream jiommand is successful; otherwise, returns 
NOTREADY: concatenated with a numeric 
representation of the reason for the condition. 
Example: NOTREADY: 110 

If operation is S, STREAM returns ERROR, 
NOTREADY, READY or UNKNOWN. 
Example: UNKNOWN 

If operation is D, the results returned are identical to the 
State operation except that the returned string is 
followed by a colon and, if available, additional 
information about ERROR or NOTREADY states. 
Example: UNKNOWN : 

Note: The STREAMQ function will not "see" hidden or 
system files. The SysFileTreeQ function in 
REXXUTIL (page 45) must be used if checking 
for a file that has the hidden or system attribute 
set 
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STRIP( string[, [option] [, char]] ) 

Returns a string with leading, trailing, or both leading 
and trailing char characters removed from string when 
the first character of option is L, T or B respectively. 
Char can only be one character long and defaults to 
blank. 

Example: 'abc' = STRIPC '.abc.', 'B', '.' ) 

SUBSTR( string, n[, [length] [, pad]] ) 

Returns the portion of string that begins at the nth 
character and is of length length, padded with pad if 
necessary. 

Example: 'bed' = SUBSTRC abedef , 2, 3 ) 

SUBW0RD( string, n[, length] ) 

Returns the portion of string that starts with the nth 
word and is up to length blank-delimited words long. 
Example: 'cd ef = SUBWORD( 'ab cd ef gh' # 2, 2 ) 

SYMBOL ( name ) 

Returns 'BAD' if name is not a valid REXX symbol, 
'VAR' if it is the name of a variable, or 'LIT' (literal) 
otherwise. 

TIME( [option] ) 

Returns the local time in the 24-hour format: hh:mm:ss, 
or in the format specified by option: 

C (Civil) hh:mmxx (where xx is 'am' or 'pm) ° 

Example: 1:12pm 
E (Elapsed seconds.hundredths) 0 (first invocation) or 

ssssssss.uuOOOO ° 
H (Hours since midnight) hh ° 
L (Long) hh:mm:ss.uuOOOO ° 
M (Minutes since midnight) mmmm ° 
N (Normal) default format hh:mm:ss 
R (Reset) sssssss.uuOOOO (and resets elapsed time) ° 
S (Seconds since midnight) sssss ° 
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TRACE ( [option] ) 

Returns trace actions currently in effect. If option is 
specified, it must be the valid prefix (?), one of the valid 
alphabetic character options (A, C, E, F, I, L, N, O, or 
R) associated with the TRACE instruction, or both. 
Unlike the TRACE instruction, the TRACE function 
alters the trace action even if interactive debugging is 
active. 

See page 13 for a description of TRACE output. 

TRANSLATE ( string [, [out__table] [, [instable] - 

- [. pad]]] ) 

Returns a string with characters in string that are in 
injable translated to the corresponding character in 
outjable {putjable is padded with pad if needed). If 
neither translate table is specified, string is translated to 
uppercase. 

Example: '12:34' = TRANSLATE ( '12/34', ':', '/' ) 

TRUNC( number [, n] ) 

Returns the integer part of number and n decimal places. 

o 

VALUE ( name[, newvalue[, selector]] ) 

Returns the value of the symbol name. A new value can 
be supplied in newvalue. 

Selector can be 'OS2ENVIRONMENT', or an expression 
that evaluates to it, to access or set system environment 
variables. System environment variables altered with this 
function remain in effect for the current program only. 
Functionally equivalent to DOSENV() (page 73) when 
selector is OS2ENVIRONMENT. 

Note 01: Use of the VALUEQ function is preferred over 
the external 'SET command to change an 
environment variable since the external SET 
command requires shelling out to CMD.EXE 
and, if the REXX program is not running under 
CMD.EXE (e.g. PMREXX), then the 
environment variable cliange is lost. 

Note 02: There is no way to change the global 
environment. 
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VERIFY( string, characters[, [option] [, start]] ) 

Returns the position of the first character in string that 
either: is not, or is, (depending on option) in characters; 
otherwise, returns 0. Option can be either NOMATCH 
or MATCH (or just the first character of either). Start, 
which defaults to 1, indicates the position in string where 
the search begins. 

Example: 4 = VERI FY( '123,456.78', '.,', 'M' ) 
1 = VERIFYC '123,456.78', '.,', 'N' ) 

W0RD( string, n ) 

Returns the nth blank-delimited word in string. Returns 
a null string if there are fewer than n words in string. 
Example: 'cd' = W0RD< 'ab cd ef gh\ 2 ) 

W0RDINDEX( string, n ) 

Returns the character position of the nth blank- 
delimited word in string. Returns 0 if there are fewer 
than n words in string. ° 

Example: 9 = WORD INDEX ( 'abc def ghi', 3 ) 

W0RDLENGTH( string, n ) 

Returns the length of the nth delimited word in string. 
Returns 0 if there are fewer than n words in string. ° 
Example: 2 = WORDLENGTH( 'a be def, 2 ) 

W0RDP0S( phrase, string ) 

Returns the word number of the first blank-delimited 
word of phrase in string; otherwise, returns 0. ° 
Example: 3 = W0RDP0S( 'ef, 'ab cd ef gh' ) 

WORDS ( string ) 

Returns the number of blank-delimited words in string. 
Returns 0 if string has a length of zero or contains only 
blanks. ° 

Example: 4 = WORDS ( 'ab cd ef gh' ) 

X RANGE ( [start] [, end] ) 

Returns a string of all one-byte codes between and 
including the values start (WX) and end ( TFX ). 
Example: 'ABCDEFGHI ' = XRANGEC 'A', 'I' ) 
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X2B( hexjtring ) 

Hexadecimal to binary. Returns a binary string 
equivalent to hexjtring (a string of hexadecimal 
characters which can contain an imbedded blank at byte 
boundaries for readability)). The returned string will 
have a length that is a multiple of four and will contain 
only the characters 0 and 1. 
Example: '10101011' = X2B( 'ab') 

X2C( hex_string ) 

Hexadecimal to character. Returns (packs) a character 
string equivalent to hexjtring (a string of hexadecimal 
characters which can contain an imbedded blank at byte 
boundaries for readability). 
Example: 'A' = X2CC '41' ) 

X2D( hex_string[, n] ) 

Hexadecimal to decimal. Returns a whole number 
equivalent to liexjtring (a string of hexadecimal 
characters which can contain an imbedded blank at byte 
boundaries for readability). ° 
Example: 65 = X2D( '4V ) 
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Many external function packages (APIs - Application Program 
Interface modules) are available for REXX running under 
OS/2. REXXUTIL is distributed as an integral part of OS/2. 
A different version of REXXUTIL is used with Object 
REXX. Other APIs can be obtained from commercial 
software sources, Internet sites, electronic bulletin boards 
(BBS), etc. 

The external function module containing each of the following 
functions is indicated by the module name at the top of the 
respective page. Where a function was introduced with a 
particular level of the module, or pertains to a particular 
version of the module, an abbreviation appears at the end of 
the function definition line. These abbreviations, and the 
external function packages they refer to, are: 

REXXUTIL (Classic REXX) 

REXXUTIL (Object REXX only) (OBJ) 

REXXLIB (Quercus Systems) 

RXWINDOW (Quercus Systems) 

2.1 REXXUTIL Functions 

REXXUTIL is an external function package included as part 
of REXX and OS/2. Two separate versions of REXXUTIL 
are available beginning with Warp Version 4 
CREXUTIL.DLL and OREXUTIL.DLL. Depending on the 
currently selected version of REXX (Classic vs. Object), its 
respective DLL is renamed to REXXUTIL.DLL. 

The currently selected version of REXX can be toggled to the 
alternate version on Warp Version 4 via the 
\OS2\SWITCHRX.CMD file. Each time the system is switched 
from Classic REXX to Object REXX, it is necessary to run 
\OS2\WPSINST.CMD after re-IPLing the system to register 
the classes used by Object REXX. 

The REXXUTIL API distributed with Object REXX contains 
additional functions not available in the REXXUTIL API 
provided with Classic REXX. These additional functions 
cannot be used with Classic REXX. REXXUTIL.DLL 
provides functions which deal with the following: 
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OS/2 System Commands 
User text or screen I/O 
OS/2 INI file I/O 
File System functions 
Mutex & Event Semaphores 
National Language functions 
Macrospace functions 
Function Library routines 



(OBJ) 
(OBJ) 
(OBJ) 
(OBJ) 



REXXUTIL.DLL must be added to the REXX processor 
using the built-in function RxFuncAdd. This can be 
accomplished by making STARTUP.CMD a REXX command 
file (by making its first line a REXX style comment - /* */) 
and including: 

call RxFuncAdd 'SysLoadFuncs' , 'Rexxllti I ' , 'SysLoadFuncs' 
call SysLoadFuncs 

Once the REXXUTIL functions or any other external 
functions are loaded, they are useable by all OS/2 sessions. 

All possible effort has been made to include all return codes 
which can result from these functions; however, there is no 
assurance that those return values listed for each function 
represent all of the possible return codes that exist. 

New functions that have been added to REXXUTIL since the 
initial release of OS/2 2.1 are indicated by the release level 
when the function was first introduced being shown at the end 
of the line containing the function's parameters. 

Note: The REXXUTIL text window functions will not 
function properly in PMREXX or other Presentation 
Manger (GUI) environments. 

SysAddFileHandle( number ) (OBJ) 

Returns the number of file handles available to the 
current session after adding number to the previously 
available number of file handles and making the sum file 
handles available to the session. If number is zero, the 
current number of file handles is returned. Similar in 
function to DOSFILEHANDLES (page 73). 

Note: File handles are used every time a file is accessed 
with REXX HO functions such as CHARIN I 
CHAROUT, LINEIN I LINEOUT, CHARS, 
LINES, and STREAM. Other services invoked 
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indirectly from REXX (e.g. SysGetMessageQ or 
other API routines) may also create open file 
handles. At least 3 Iiandles are usually in use for 
the standard input stream, standard output, 
stream, and standard error stream. 



SysAddRexxMacro( functionjiame, file name - 

- [, position] ) (OBJ) 

Returns the RexxAddMacro() return code after adding 
fdejiame to the REXX macrospace as function name. 
Functionjiame is the name used to call the function. If 
no file extension is specified for filejiame, .CMD is 
assumed. When a path is not specified for file name, the 
current directory and PATH environment are searched. 
Position is either B, indicating that the macrospace 
should be searched before the list of registered functions 
and functions on disk; or, A indicating that the 
macrospace should be searched after a search is made of 
registered functions and functions on disk. 



0 Macro added successfully 

1 Error - no storage available 

7 Error - source not found 

8 Error - invalid position 



SysBootDrive() (OBJ) 

Returns the one character disk letter, in uppercase, 
followed by a colon of the system boot drive. Similar in 
function to DOSBOOTDRIVE (page 67). 

SysCl earRexxMacroSpace () (OBJ) 

Returns the RexxClearMacroSpace() return code after 
removing all macros from the macrospace. 

0 Macrospace cleared 

2 Error - macrospace already cleared 



©1993-1997 by C F S Nevada, Inc. 



38 



Rev 4.0 



REXXUTIL 



SysCloseEventSem( handle ) (OBJ) 

Returns the DosCloseEventSem return code after 
closing the event semaphore identified by handle and 
releasing its associated storage. Handle is the value 
returned by a successful call to SysCreateEventSemQ. 

0 Semaphore closed 
6 Error - invalid handle 
301 Error - semaphore busy 

SysCloseMutexSem( handle ) (OBJ) 

Returns the DosCloseMutexSem return code after 
closing the mutex semaphore identified by handle and 
releasing its associated storage. Handle is the value 
returned by a successful call to SysCreateMutexSem(). 

0 Semaphore closed 
6 Error - invalid handle 
301 Error - semaphore busy 

SysClsO 

Returns 0 and clears a window but not necessarily the 
entire screen. Similar in function to SCRCLEAR (page 
92). 

SysCopyObject( objectjiame, object_desti nation ) V3 

Returns 1 if objectjiame was successfully copied to 
object destination', otherwise, returns 0. If the object 
already exists in the destination location, it is not copied 
and a 0 is returned. 

Both objectjiame and object _destination can be a WPS 
object ID (the unique string preceded with a '<' and 
terminated with a '>') assigned to the object when it was 
created (e.g. <WP_DESKTOP>) or a fully qualified file 
name. The predefined object IDs are shown in Section 
4.1 beginning on page 107. 

Note 01: The copied object will not have an OBJECTID 
whether the original object had one assigned or 
not 

Note 02: Some of the objects other properties are not 
copied along with the object Specifically, 
ASSOCTYPE= belonging to the original object 
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does not appear on tJie copy. This is consistent 
with what occurs when using drag & drop to cop) 
an object. 

5ysCreateEventSem( [name] ) (OBJ) 

Returns an event semaphore handle after attempting tc 
create or open an OS/2 event semaphore; otherwise 
returns a null string. The handle that is returned can be 
used with SysOpenEventSem(), SysCloseEventSem() 
SysResetEventSem(), SysPostEventSemQ, anc 
SysWaitEventSem(). SysCreateEventSem() returns a mil 
string if the event semaphore cannot be created 01 
opened. 

If you omit the optional event semaphore name. 
SysCreateEventSem() creates an unnamed, shared even' 
semaphore. If you specify name, SysCreateEventSem^ 
opens the semaphore if the semaphore has already beer 
created. The file system validates semaphore names 
which must include the prefix \SEM32V. 

SysCreateMutexSem( [name] ) (OBJ) 

Returns a mutex semaphore handle after attempting tc 
create or open an OS/2 mutex semaphore; otherwise 
returns a null string. The handle that is returned can be 
used with SysOpenMutexSem(), SysCloseMutexSem() 
SysRequestMutexSem(), and SysReleaseMutexSemQ 
SysCreateMutexSem() returns a null string if the mute^ 
semaphore cannot be created or opened. 

If you omit the optional mutex semaphore name 
SysCreateMutexSem() creates an unnamed, sharec 
mutex semaphore. If you specify name 
SysCreateMutexSem() opens the mutex semaphore if the 
semaphore has already been created. The file systeir 
validates mutex semaphore names, which must include 
the prefix \SEM32\\ 

SysCreateObject( dass_name, title, location - 

- [, setup_string] [, option] ) 

Returns 1 if a new object class was created; otherwise 
returns 0. 

Class name is the name of the WPS class of which the 
object is a member and title is the new object's title. A 
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new line character, 'OA'x, can be included in title. The 
occurrence of the escape character A ('5E'x) also causes a 
new line to be created; however, 2nd and subsequent 
escape characters used for this purpose appear to be 
ignored. 

Location can be either an object ID (any unique string 
preceded with a '<' and terminated with a '>') or a full 
file system path. 

Setup jtring optionally must contain a WinCreateObject 
string which is comprised of a series of "key 
name = value" pairs that change the behavior of the 
object. "Key names" are separated by semicolons and 
"values" are separated by commas. 

Note: If a value includes a semicolon (; - *3B x x) or a 
comma ( f - x 2Cx), it must be "escaped" by 
preceding it with a caret (* - '5Ex). 

Option is a string which indicates the action to be taken 
if the object class already exists and can be: FAIL, 
REPLACE or UPDATE. 

Section 4.2 describes the predefined class jiames 
beginning on page 124 and section 4.3 contains the 
setup _string data beginning on page 126. 

5ysCreateShadow( objectjiame, object_desti nation ) 

V3 

Returns 1 if a shadow of object jiame was successfully 
created at the specified location, object ^destination; 
otherwise, returns 0. 

Both objectjiame and object jiestination can be a WPS 
object ID (the unique string preceded with a '<' and 
terminated with a '>') assigned to the object when it was 
created (e.g. <WP_DESKTOP>) or a fully qualified file 
name. The predefined object IDs are shown in Section 
4.1 beginning on page 107. 
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SysCurPos( [row, col] ) 

Returns the current relative cursor position on the 
screen as two whole numbers, row and column, and 
optionally moves the cursor to the position specified in 
row and col.° The first column of the first row is 
returned as 0 0. Similar in function to CURSOR (page 
65). 

Example: 4 1 

SysCurState( {ON | OFF} ) 

Returns a value of 0 and changes the current state of 
the cursor to display able (ON) or non-displayable (OFF). 

SysDeregisterObjectClass( classjiame ) 

Returns the resultant code from 
WinDeregisterObjectClass: 1 if classjiame was 
successfully unregistered; otherwise, returns 0. Section 
4.2 describes the predefined WPS classes beginning on 
page 124. 

SysDestroyObject( objectjiame ) 

Returns the resultant code from WinDestroyObject: 1 if 
objectjiame is destroyed; otherwise, returns 0. 
Objectjiame is either the object ID (the unique string 
preceded with a '<' and terminated with a '>') assigned 
to the object when it was created or the full file system 
name of the object to be destroyed. Some of the 
predefined object IDs are shown in Section 4 beginning 
on page 107. 

SysDriveInfo( drive ) 

Returns 4 words describing drive or a null string if drive 
contains an expression which does not evaluate to a 
drive letter or if the specified drive is not ready. 

Word 1 contains the drive letter, in uppercase, followed 
by a colon. Word 2 contains the number of free bytes on 
drive. Word 3 contains the total number of bytes on 
drive. Word 4 contains the volume label from drive. ° 
Example: D: 19118080 63031296 0S2 
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SysDriveMap( [drive], [opt] ) 

Returns a string of all accessible drives as the drive 
letter in uppercase followed by a colon, optionally 
beginning with drive. If drive is omitted, the default is C. 
Opt causes only the specified type of drives to be 
returned and can be: 

USED Only drives which are accessible or in use. 

FREE Drives which are free or not in use (i.e. 

all drive letters beyond the last drive 

used). 

LOCAL Only local drives are returned. 
REMOTE Only LAN and IFS attached drives are 
returned. 

DETACHED Drives which are detached LAN 

resources. 
Example: C: D: E: 

SysDropFuncs() 

This function is an entry point within REXXUTIL that 
can be invoked or called to drop all of the REXXUTIL 
functions. It returns a null string if REXXUTIL was 
loaded but will trap on SYNTAX if REXXUTIL is not 
loaded. 

SysDropLibrary( DLL[, drop_routine] ) (OBJ) 

Returns 0 after successfully calling the droproutine in 
DLL to terminate and deregister all of the functions in 
DLL; otherwise, returns 1. If drop routine is not 
specified, SysDropLibrary() will call ordinal routine #2 
in the DLL. 

SysDropRexxMacro( name ) (OBJ) 

Returns the return code from RexxDropMacro after 
removing name from the macrospace. 

0 Macro removed 

2 Error - name not found 

SysElapsedTime( [option] ) (OBJ) 

Returns a time value in the format sssssssss.uuuuuu? 
The fractional part will always have six digits. 

Option can be: 
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E Elapsed - returns the number of seconds and 
microseconds since the elapsed time clock was 
started or reset, (default) 

R Reset - returns the number of seconds and 
microseconds since the elapsed time clock was 
started or reset and also simultaneously resets the 
elapsed time clock to zero. 

Note: SysElapsedTimeQ reports an elapsed time using 
the OS/2 high-frequency timer services. The high- 
frequency timer services have a higher timer 
resolution than the timer services used by the 
TIMEQ built-in function. SysElapsedTimeQ 
maintains a single, process-wide time stamp for 
measuring elapsed time. In contrast with the 
TIMEQ built-in function, the time stamp is not 
saved and restored on subroutine calls and 
multiple calls to SysElapsedTimeQ in a single 
instruction will use different versions of tlie time 
stamp. 

SysFileDelete( filejiame ) 

Returns one of the following codes after attempting to 
delete filejiame. Functionally equivalent to DOSDEL0 
(page 69). 



0 


File deleted successfully. 


2 


Error 


- file not found. 


3 


Error 


- path not found. 


5 


Error 


- access denied. 


26 


Error 


- Not a DOS disk. 


32 


Error 


- sharing violation. 


36 


Error 


- Sharing buffer exceeded. 


87 


Error 


- invalid parameter. 


123 


Error 


- invalid file name. 


206 


Error 


- file name exceeds range. 



SysFileSearch( needle, haystack, stem, [opt] ) 

Returns a whole number indicating the result of 
searching for the string needle in the file haystack. Stem 
is a variable where all lines found in haystack which 
contain needle are placed. Stem.O will contain the total 
number of lines found if the return code from the 
function is 0. 
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Opt can optionally contain the letters C (case sensitive 
search) and/or N (include line numbers on matches). If 
line numbers are requested via the N option, the line 
number is the first word in the string placed in the stem 
element. ° 

0 Successful. 

2 Error - not enough memory. 

3 Error opening file. 

SysF*Ue$ystemType( drive ) (0B0) 

Returns the name of the file system used on drive or a 
null string if djive is not accessible. Dfive can be 
specified with a drive letter, optionally followed by a 
colon. Functionally equivalent to DOSFILESYS() (page 
74). The values returned can be: 

null Drive not accessible 

CDFS CD-ROM file system 

FAT FAT file system 

HPFS High performance file system 

LAN Network drive 

SysFileTree( filespec, stem[, opt] - 

- [, targ_attr][, new attr] ) 

Returns^ whole number indicating the success (0) or 
failure (1 - not enough memory) of a file search which 
finds all files which match filespec. 

Stem will contain the file characteristics (date, time, size, 
attribute string and fully qualified file name) for 
matching entries. 

Note: Since file names on an HPFS drive may 
include spaces, the following technique is 
recommended for parsing the data in stem: 

PARSE VALUE stem. n WITH, 

file_date # 

f i le_time, 

f i le_size, 

f i le_attributes, 

f i I e_path_and__name 
f f I e_path_and_7name = STRIPCf i L e_pa th_and_name) 
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Opt contains any logical combination of the of the 
following: 

B Search for both files and directories, (default) 
D Search for directories only. 
F Search for files only. 

S Scan subdirectories recursively, (non-default) 

T Return time and date fields concatenated in the 

form YY/MM/DD/HH/MM. 
O Only report the fully qualified file name rather than 

the default of: 

MM/DD/YY° HH:MMp° size 0 attr_List name 

The attribute lists returned or specified are 5 byte 
positional character strings containing the letters 
Archive, Directory, Hidden, Read-only, or System 
respectively or another character representing that the 
particular attribute is not set (returned list) or as 
indicated below for targ_attr and new jittr. 

The target attribute list, targjittr, is used as a mask when 
searching for filespec matches. Only filespecs which match 
the mask will be reported. The default mask is '****♦' 
and each position corresponds to ADHRS noted above. 
Each position of the targjittr mask can contain: 

* The specified attribute can be set or clear. 
+ The specified attribute must be set. 

The specified attribute must be clear. 

The new attribute list, new jittr , is used as a mask to set 
the attributes of all files matching targattr. The default 
mask is •*****' and each position corresponds to 
ADHRS noted above. Each position of the new jittr 
mask can contain: 

* The specified attribute will not be changed. 
+ The specified attribute will be set. 

The specified attribute will be cleared. 

Note: new jittr will have no effect when option 'O' is 
specified. 
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SysGetCollate( [country], [code_page] ) (OBJ) 

Returns the 256-byte collating table country and 
optionally code jpage combination. If country or 
code jfage are omitted or contain 0 (the default), the 
collating table for the current system country code 
and/or current process code page is returned. 

SysGetEA( file, eajiame, ea_value ) 

Returns 0 indicating the eajiame extended attribute for 
file has been retrieved and placed in eajsalue; non-zero 
otherwise. All of the standard system extended attributes 
are null-terminated strings. The STRIP () function can be 
used to remove the terminating null character. 
Example: ea_value = STRIP( ea_value, 'T', '00'x ) 

SysGetKey( ECHO | NOECHO ) 

Returns the next key from the keyboard buffer without 
waiting for the Enter key. The key is echoed or not 
according to the option specified. A list of all of the 
possible combinations of keys and the data returned by 
this function for each key is listed in Appendix B (page 
211). Functionally equivalent to INKEY() (page 83). 

SysGetMessagef num[, file[, string_l] - 

- ... [, string_9] ) 

Returns the message associated with num in the message 
file file. String ji contains replacement fields in the 
message designated by %n, in the range %1 - %9. 
Example: 

say SysGetMessage( 46, 'OSO001 .MSG' , 'Test' ) 
yields: 

SYS0046: The Test printer is out of paper. 



Syslni ( [inifile], app, key, value ) 1 

Syslni( [inifile], app, key ) 2 

Syslni ( [inifile], app, key, 'DELETE:' ) 3 

Syslni ( [inifile], app, 'DELETE: 1 ) 4 

Syslni ( [inifile], app, 'ALL: 1 , stem ) 5 

Syslni ([inifile], 'ALL:', stem) 6 



Returns ERROR: if the function invocation results in an 
error condition. 

Returns a null string after successfully setting key to 
value for app (form 1). 

Returns the value associated with key for app (form 2). 
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Returns a null string after successfully deleting key (form 
3) or app and all of its associated keys (form 4). 

Returns a null string after placing all key values for app 
in stem (form 5). 

Returns a null string after placing all application names 
or other meaningful names in stem (form 6). 

Inifile is the full file system name of an INI file or 
USER (value of the SET USERJNI= environment 
variable), SYSTEM (value of the SET SYSTEMJNI= 
environment variable) or BOTH. If a user .INI file is 
specified, a setting function (form 1) will cause the user 
.INI file to be created if it does not already exist or to 
be updated if it does exist. 

App is an application, or other meaningful value, that 
key word data should be saved with. Key is the name of 
the keyword associated with app. 

Value is a string associated with key for a specific app. 

Stem is the name of a stem variable used to store the 
resultant information with stem.O containing the number 
of elements in stem. 

See the SysIniQ function in the OS/2 REXX Information 
on-line help facility for an example of how to list all of 
the program objects in your system. 

SysLoadFuncs() (OBJ) 

Returns a null string after loading all of the functions 
contained in REXXUTIL.DLL. 

SysLoadLibrary( DLL[, loadjroutine] ) (OBJ) 

Returns 0 if loadjoutine was successful; otherwise, 1. 
DLL is the name of the library module. Loadjoutine is 
the name of the function loader routine in the DLL. If 
loadjoutine is not specified, SysLoadLibraryQ will call 
ordinal routine #1 in the DLL. 
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5ysLoadRexxMacroSpace( file ) 



(OBJ) 



Returns the RexxLoadMacroSpace return code after 
loading functions from a saved macrospace file 
previously created with SysSaveMacroSpaceQ. 



SysMapCase( string[, country,] [codepage] ) (OBJ) 

Returns string uppercased according to the country and 
code _page specified. A country value of 0 results in a 
translation table for the current system countiy code. A 
code _page value of 0 results in a translation table for the 
current process code page. 

SysMkDirf dirspec ) 

Returns one of the following codes resulting from the 
attempt to create directory dirspec. Functionally 
equivalent to DOSMKDIRQ (page 75). 



0 


Directory created successfully. 


2 


Error - 


file not found. 


3 


Error - 


path not found. 


5 


Error - 


access denied. 


26 


Error - 


Not a DOS disk. 


87 


Error - 


invalid parameter. 


108 


Error - 


drive locked. 


206 


Error - 


filename exceeds range. 



SysMoveObject( object_name, object_desti nation ) V3 

Returns 1 if objectjmme was successfully moved to 
object ^destination', otherwise, returns 0. If the object 
already exists in the destination location, it is not moved 
and a 0 is returned. 

Both object jiame and object _destination can be a WPS 
object ID (the unique string preceded with a '<' and 
terminated with a '>') assigned to the object when it was 
created (e.g. <WP_DESKTOP>)or a fully qualified file 
name. The predefined object IDs are shown in Section 
4.1 beginning on page 107. 
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Functions loaded successfully. 
Error - no storage available 
Error - macro not found 



Error - macro already exists 
Error - file error 



Error - signature error 
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SysNational LanguageCompare( stringl, string2 

- [, country] [, codepage] ) OB 

Returns a value indicating the result of comparing string 
and stringl using a country-specific collating table. / 
country value of 0 results in a collating table for tto 
current system country code. A code _page value of I 
results in a collating table for the current process cod 
page. 

0 The two strings are equal. 

1 The first string is longer than the second string. 
-1 The second string is longer than the first string. 

Note: Comparisons are done using the Rexx string 
comparison rules. The strings are compared fo 
the length of the sliorter string. If the leading par 
is equal, then the longer string is considered to b< 
larger. An equal comparison can only occu 
between strings of equal lengtlis. 

SysOpenEventSem( handle ) (OBJ] 

Returns the DosOpenEventSem return code afte: 
attempting to open the event semaphore pointed to b] 
handle. Handle is the value returned by a successful cal 
to SysCreateEventSemQ. 



0 Event semaphore opened successfully 

6 Error - invalid handle 

8 Error - insufficient memory 

87 Error - invalid parameter 

123 Error - invalid name 

187 Error - event semaphore not found 

291 Error - too many opens 

SysOpenMutexSem( handle ) (OBJ) 

Returns the DosOpenMutexSem return code aftei 
attempting to open the mutex semaphore pointed to bj 
handle. Handle is the value returned by a successful caL 
to SysCreateMutexSemQ. 

0 Mutex semaphore opened successfully 

6 Error - invalid handle 

8 Error - insufficient memory 

87 Error - invalid parameter 

105 Error - semaphore owner died 
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123 Error - invalid name 

187 Error - event semaphore not found 

291 Error - too many opens 

SysOpenObject( objectjiame, view, flag ) V3 

Returns 1 if the WPS object object name was 
successfully opened on the Desktop; otherwise, returns 
0. 

Object jiame can be a WPS object ID (the unique string 
preceded with a and terminated with a '>') assigned 
to the _ object when it was created (e.g. 
<WPJ)ESKTOP>) or a fully qualified file name. The 
predefined object IDs are shown in Section 4.1 beginning 
on page 107. 

View specifies the view to be opened and can contain 
either a numeric value or the equivalent string. The 
function will pass all numeric values to the underlying 
wpOpen() or wpViewObject() function without testing 
the value for validity. 

0 - DEFAULT 

1 - ICON 

2 - SETTINGS 

3 - HELP 

4 - RUNNING 

5 - PROMPTDLG 
121 - PALETTE 

Flag can contain a 1 indicating that an existing view of 
an object can be opened on top of the Desktop 
(resurfaced) by calling the wpViewObject method or a 
0 indicating that the view specified in view is to be 
opened using the wpOpen method. The following 
comment originated in the description of the wpOpen 
method: 

n In general, wpViewObject should be used instead of the 
wpOpen method. This is because wpViewObject takes into 
consideration the setting in the Object Open Behavior field 
on the Window page of the Settings notebook for the object. 
If a view of the object is already open, wpViewObject will 
depending on the setting of the Object Open Behavior field, 
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either display the existing window for the object or create a 
new object" 

"In contrast, wpOpen always opens a new view of the 
object Under certain circumstances this might be called 
for, but, under most circumstances, wpViewObject should 
be called instead" 

SysOS2Ver() 

Returns a string containing OS/2 version information in 



the form: xjk. 

Example: 2.10 (pre V3) 

2.30 (V3) 

2.40 (V4) 

SysPostEventSem( handle ) (OBJ) 



Returns the DosPostEventSem return code after posting 
the event semaphore indicated by fiandle. Handle is the 
value returned by a successful call tc 
SysCreateEventSem(). 

0 Event semaphore posted successfully. 

6 Error - invalid handle 

298 Error - too many posts 

299 Error - already posted 

SysProcessTypeQ (OBJ] 

Returns the type of process in which the REX> 
program is running. Functionally equivalent tc 
DOSSESSIONTYPE() (page 77). 

0 Full screen protect mode session 

1 Requires real mode (cannot occur) 

2 VIO windowable protect mode session 

3 Presentation Manager protect mode session 

4 Detached protect mode process 

SysPutEA( file, eajiame, eavalue ) 

Returns 0 if the eajiame extended attribute data i: 
ea jyalue has been written to file; otherwise, returns th 
OS/2 return code of the failing function. 

Note: Standard system extended attributes ar 
terminated with a null character - Wx 
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SysQueryClassList( stem ) 

Returns 0 after stem receives the entire set of registered 
classes and stem.O is set to the number of registered 
classes. Each element of stem contains two words: class 
name and module name (i.e. DLL name). For some user 
defined classes, the full file system name is placed in 
stem.n. 

Example: WPObject PMWP 

UPSystem WPCONFIG 

SysQueryEALi st ( filejiame, stem ) (OBJ) 

Returns 0 after assigning the extended attribute names 
associated with filename sequentially to stem with stem.O 
being assigned the number of extended attribute names 
retrieved; otherwise, returns the OS/2 error code of the 
failing function. 

SysQueryProcessCodePage () (OBJ) 

Returns the current code page for the process. 

SysQueryRexxMacro( functionjiame ) (OBJ) 

Returns the position in the macrospace of function jtame 
('B' -before, 'A' - after) relative to external searching; 
otherwise, returns a null string (a zero-length string) if 
function jiame is not located in the macrospace. 

SysQuerySwitchList( stem ) (OBJ) 

Returns 0 after sequentially assigning the contents of the 
system switch list to stem. Stem.O will contain the number 
of entries in the switch list. A minimal switch list may 
contain entries such as: 

Switch to 

WarpCenter 

Desktop 

MUGLRQST.EXE 

Workplace Shell 

PMSPOOL.EXE 

Note: The Warp 4 switch list contains a blank entry. 

SysRegisterObjectClass( classjiame, modulejiame ) 

Returns the resultant code from 
WinRegisterObjectClass: 1 if the class is registered 
successfully; otherwise, returns 0. 

This function will register a new classjiame and its 
associated modulejiame (i.e. DLL name) to the system. 
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SysReleaseMutexSem( handle ) 



(OBJ) 



Returns the return code from DosReleaseMutexSem 
after attempting to release ownership of the mutex 
semaphore identified by handle. Handle is the value 
returned by a successful call to SysCreateMutexSemQ, 



288 Error - not owner 

SysReorderRexxMacro( functionjiame, order ) (OBJ) 

Returns 0 after successfully reordering j unction jiame in 
the REXX macrospace; otherwise, returns the return 
code from RexxReorderMacro. Order indicates the 
position in the macrospace of function name ('B' -before, 
'A f - after) relative to external searching. 

0 Reorder successful 

4 Error - function not found 

8 Error - invalid position 

SysRequestMutexSem( hand1e[, timeout ) (OBJ) 

Returns the return code from DosRequestMutexSem 
after successfully acquiring ownership of the mutex 
semaphore identified by handle. Timeout is a value, in 
microseconds, to wait on the semaphore. The default 
timeout is an indefinite wait. Handle is the value returned 
by a successful call to SysCreateMutexSem(). 

0 Ownership acquired successfully 

6 Error - invalid handle 

95 Error - interrupt 

103 Error - too many requests 

105 Error - semaphore owner died 

640 Error - timeout 

SysResetEventSem( handle ) (OBJ) 

Returns the return code from DosResetEventSem after 
attempting to reset the event semaphore identified by 
handle. Handle is the value returned by a successful call 
to SysCreateEventSem(). 

0 Event semaphore reset 
6 Error - invalid handle 
300 Error - semaphore already reset 



0 
6 



Ownership released successfully 
Error - invalid handle 
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SysRmDir( dirspec ) 

Returns one of the following codes resulting from the 
attempt to delete dirspec. Functionally equivalent to 
DOSRMDIRQ (page 77). 



0 


Directory removed successfully. 


2 


Error - file not found. 


3 


Error - path not found. 


5 


Error - access denied. 


16 


Error - current directory. 


26 


Error - Not a DOS disk. 


87 


Error - invalid parameter. 


108 


Error - drive locked. 


206 


Error - filename exceeds range. 



SysSaveObject( objectjiame, timing_flag ) V3 

Returns 1 if the WPS object objectjiame was 
successfully saved; otherwise, returns 0. File system 
objects (WPFileSystem) are saved in the file system's 
extended attributes and abstract objects are saved in the 
OS2.INI (user) file. Transient objects (WPTransient) 
cannot be saved. 

Objectjiame can be a WPS object ID (the unique string 
preceded with a '<' and terminated with a '>') assigned 
to the object when it was created (e.g. 
<WP_DESKTOP>) or a fully qualified file name. The 
predefined object IDs are shown in Section 4.1 beginning 
on page 107. 

Timing Jlag can be 0 (Boolean false - object is to be 
saved synchronously) or 1 (Boolean true - object is to 
saved asynchronously). If an asynchronous save is 
specified, the object will be saved on a separate thread 
("lazy written"); this is the preferred method for saving. 
Otherwise, the object is saved on the user interface 
thread. 



SysSaveRexxMacroSpace( filejiame ) (OBJ) 

Returns the return code from RxxSaveMacroSpace after 
attempting to save all of the m aerospace to file jiame. 

0 Save successful 

2 Error - macros not found 
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3 Error - file requires an extension 

5 Error - file error 

SysSearchPath( env_path, file name ) 

Returns the fully qualified name of filename if it can be 
found by a search of the environment path identified by 
env _path (PATH, DPATH, etc.); otherwise, returns a 
null string. LIBPATH is not included in the search since 
it is not contained within the environment variables. 
Functionally equivalent to DOSPATHFIND0 (page 75). 

SysSetFileHandle( number ) (OBJ) 

Returns the DosSetMaxFH return code after attempting 
to set the number of available file handles in the current 
process to number. Functionally equivalent to 
DOSFILEHANDLES() (page 73). 

0 Number of file handles set successfully. 
8 Error - insufficient storage 

87 Error - invalid parameter 

SysSetIcon( filejiame, iconjfilejiame ) 

Returns the resultant code from WinSetlcon: 1 if 
icon Jilejiame is successfully associated with file name; 
otherwise, returns 0. 

SysSetObjectData( objectjiame, setup_string ) 

Returns the resultant code from WinSetObjectData: 1 if 
objectjiame is successfully updated; otherwise, returns 0. 

Objectjiame can be a WPS object ID (the unique string 
preceded with a '<' and terminated with a *>') assigned 
to the object when it was created (e.g. 
<WP_DESKTOP>) or a fully qualified file name. The 
predefined object IDs are shown in Section 4.1 beginning 
on page 107. 

Setup jtring must contain a WinCreateObject string 
which is comprised of a series of "key name = value" pairs 
that change the behavior of the object. "Key names" are 
separated by semicolons and "values" are separated by 
commas. Key names begin on page 126. 
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SysSetPriority( class, delta ) (OBJ) 

Returns the DosSetPriority return code after attempting 
to change the priority of the current session. The 
following priority classes can be specified in class: 



0 No change, change priority delta only 

1 Idle time priority class 

2 Regular priority class 

3 Time critical priority class 

4 Foreground server priority class 



Delta represents a change that can be made to the 
process priority level. It must contain an integer value in 
the range of -31 to +31. Functionally equivalent to 
DOSPRIORITYQ (page 76). 



0 Priority changed successfully 

303 Error - invalid process ID 

304 Error - invalid delta 

305 Error - not descendant 

307 Error - invalid class 

308 Error - invalid scope 

309 Error - invalid thread ID 



SysSetProcessCodePage( code_page ) (OBJ) 

Returns the return code from DosSetProcessCp after 
altering the current code page for the process to 
code _page. 

0 Code page set successfully 
472 Error - invalid code page 

SysShutDownSystem() (OBJ) 

Returns 1 after initiating a successful OS/2 system 
shutdown; otherwise, returns 0. 

SysSleep( seconds ) 

Returns 0 after the current session awakes from a sleep 
(wait) state for seconds. Functionally equivalent to 
DELAYQ (page 66). 
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SysSwitchSession( sessionjiame ) (OBJ) 

Returns 0 after attempting to switch the focus to 
session name; otherwise, returns a non-zero value. 
Session name must contain the session name as it 
appears in the window list and can be retrieved with the 
SysQuerySwitchList() function. 

Note: If sessionjiame contains a non-switchable 
session, focus may be switched to the Window 
List. 

SysTempFileNamef tempi ate [, {? | filter}] ) 

Returns a unique file or directory name which does not 
exist, according to template; otherwise, returns a null 
string. Filter is a single character whose occurrence in 
template is replaced with a numeric digit. Template may 
not exceed a length of 5. Functionally equivalent to 
DOSTEMPNAME() (page 78). 

SysTextScreenRead( row, col [, length] ) 

Returns a character string from the screen, beginning at 
row and col, of length or through the end of the screen, 
including CR & LF characters if the read spans across 
screen lines. The first column of the first row is 
referenced as 0 0. 

SysTextScreenSi ze () 

Returns two words indicating the size of the screen in 
rows and columns. Functionally equivalent to 
SCRSIZE() (page 94). 

SysWaitEventSem( handle[, timeout] ) (OBJ) 

Returns the DosWaitEventSem return code after waiting 
on the event semaphore identified in handle. Timeout 
represents the time, in milliseconds, to wait on the 
semaphore. The default timeout is an indefinite wait. 

0 Event has occurred 

6 Error - invalid handle 

8 Error - insufficient memory 

95 Error - interrupted 

640 Error - timeout 
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SysWaitForShell ( event[, queryflag] ) (OBJ) 

Returns 1 (true) if event has occurred; otherwise, returns 
0 (false). Event is a specific initialization event of the 
Workplace Shell and can be: 

DESKTOPCREATED Wait until Desktop has 
been created. 

DESKTOPOPENED Wait until Desktop has 
been opened. 

DESKTOPPOPULATED Wait until Desktop 

has been populated. 

If query Jlag is not specified, the function call will only 
return when the event has occurred. If query Jlag 
contains the string QUERY, the function will return 
immediately and reflect the current status in the return 
value. 

SysWaitNamedPipe( name[, timeout] ) 

Returns the resultant code from DosWaitNPipe after 
waiting for the named pipe name (\PIPE\pipename). 

0 The named pipe is no longer busy. 
2 The named pipe was not found. 
231 The wait timed out before the pipe became 
available. 

Timeout can be: 

omitted use default time. 

-1 wait until pipe is no longer busy. 

microsecs wait for the specified time. 

SysWildCard( source jiame, wild_card ) (OBJ) 

Returns an edited file name resulting from the 
combination of source jiame and wild_card. Wildcard is 
an editing pattern composed of file name wildcard 
characters ? and *. The edited result is the 
transformation resulting from the DosEditName 
function. 
Example: 

Source Edit Pattern Result 

abc.src *.bak abc.bak 

xyz.src abc* abc.src 

zoot.src f???.bak foot.bak 
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3. Other Rexx External Function 
Modules 



REXXLIB and RXWINDOW are a combined, commercially 
available, external function package which provides an 
extensive array of enhancements in addition to those provided 
by REXXUTIL. 

A fully functional demonstration version of REXXLIB that 
includes all the functions listed here can be downloaded from 
httpillwww. quercus-sys. com . 

The information provided here is done so with the expressed 
permission of Quercus Systems. This handbook is not intended 
to replace the requirement of the Quercus documentation for 
the proper use of REXXLIB and RXWINDOW. 

Some functions in REXXLIB duplicate those provided by 
REXXUTIL, but many are unique. REXXLIB, as part of 
Personal REXX, preceded OS/2 SAA REXX in the 
marketplace. Many of the OS/2 REXXLIB functions are 
identical to those provided with Personal REXX for DOS. 

Quercus provides the REXXLIB User's Guide along with 
REXXLIB. In the event of any discrepancies between the 
material as presented here and the material as presented in 
the REXXLIB User's Guide, the Quercus publication should be 
assumed to be correct. Quercus also provided technical editing 
and guidance in the preparation of this entire handbook. 

Quercus can be reached at: 

P.O. Box 51218 

Pacific Grove, California 93950 

408-372-7399 (voice) 

408-372-5776 (FAX) 

http://www.quercus-sys.com 

GO CIS:QUERCUS (CompuServe - 75300,2450) 

REXXLIB contains the following functions by type: 

• Mathematical functions including logarithms, 
exponentiation, trigonometric, hyperbolic and others. 
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• Stem and array functions including those which allow 
array sorting, array item insertion and deletion along 
with the ability to copy an entire array. 

The ability to manipulate compound arrays as well as 
functions which allow simple and compound arrays to be 
written to, and read from, disk. Also REXX arrays can 
be written to, as well as read from, ASCII disk files. 

• OS/2 Information Services including: additional 
Extended Attribute support, enhanced file control 
functions as well as many miscellaneous functions such 
as the ability to determine the boot drive, place the OS/2 
environment variables into a REXX array, determine the 
OS/2 file system type, and more. 

• Hardware information and access functions which return 
data about the system that the program is running on, 
screen manipulation functions, and a special facility for 
reading from the keyboard as well as controlling the 
keyboard's typematic rate. 

• An extensive collection of semaphore functions is 
included to provide an advanced Interprocess 
Communication capability. 

Like REXXUTIL, REXXLIB and/or RXWINDOW must be 
loaded and REXX must be informed of their presence. This 
task is accomplished in a similar fashion to REXXUTIL and, 
once registered, each function is available to all other REXX 
sessions. REXXLIB can be registered with: 

call RxFuncAdd 'RexxLibRegister' , -» 

- 'REXXLIB', 'rexxlibregister' 

call RexxLibRegister 

It can be removed (unregistered) with: 
call RexxLibDeRegister 

RXWINDOW can be registered with: 

call RxFuncAdd 'W_Register' , 'RXWIN30', 'rxwindow' 
call W_Register 

It can be removed (unregistered) with: 
call WJ)eregister 
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3.1 REXXLIB Functions 



AC0S( angle ) 

Returns the inverse of the cosine of angle (expressed in 
radians in the range of 0 to n). Angle must be a real 
number in the range -1 angle < 1 otherwise, 'NAN' 
(Not A Number) is returned. ° 

ARRAYCOPY( from_stem, to_stem[ t from] [, to] [ t ct] ) 

Returns 1 if from jtem is successfully copied to tojtem; 
otherwise, returns 0. Fromjtem and tojtem are the 
source and target array stems. From and to represent the 
position in the respective arrays, with a default of 1, and 
ct indicates the number of array elements to be copied. 

ARRAYDELETE( stem, from[, ct] ) 

Returns 1 if one, or the number of elements indicated in 
ct, are successfully deleted from stem beginning at 
element from; otherwise, returns 0. 

After successful deletion, the remaining initialized 
elements in the array are shifted downward. 

ARRAYINSERT( fromstem, to_stem,[, from] - 

- [, to][, ct] ) 

Returns 1 if one, or the number of elements indicated in 
ct, and located in from _stem are successfully inserted into 
to stem. Source elements in from jtem begin at from, 
with a default of 1, and are inserted into tojtem at the 
position following to. To defaults to the number of 
elements in tojtem prior to the function being invoked. 

ARRAYSEARCH( search_stem, result_stem, pattern - 

-> [, options] [, from][, count] ) 

Returns the number of tails found while, at the same 
time, placing the indices of a REXX array {search jtem) 
into a new array (result jtem) for each index where the 
corresponding variable value matches a pattern. 

Search jtem represents a REXX array to search. 
Result jtem is the stem name that identifies the output 
array. Pattern is a regular expression that is used to 
select tails. 
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Options indicates the type of search performed from the 
default, which is a case-insensitive search using a regular 
expression pattern. The value can be a string consisting 
of one or more of the following: 

A Select only items that do not satisfy the search 

conditions (Avoid). 
C Search should be case sensitive. 
F Exact match required between pattern and first 

substring of target, except possibly for case, no 

regular expressions. 
S Simple search that does not use regular 

expressions. 

X Exact match required between pattern and 
target, except possibly for case, no regular 
expressions 

From represents the position in the first array at which 
the search begins. The default is 1. Count is the number 
of items to search. The default is all items, to the end of 
the array. 

Notes: Element 0 of the output array is set to the 
number of tails found. 

The input and output compound variables must 
be different. 

ARRAYSEARCH is usually faster than 
CVSEARCH wJren the compound variable to be 
searched lias only positive integral "subscripts", as 
is the case, for instance, with the result of 
FILEREAD. 

You should avoid using a regular expression 
search by specifying % S> in the options string if the 
pattern may contain any of the characters that 
have special meaning in regular expressions (T, 
« A « «j« it « «.« .t*» .. + « h ? » iy» and unless 

the characters are escaped by being preceded with 
"\". Tftis is especially likely to be a problem if the 
pattern is entered as user input at run time or 
consists of a file name. 
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ARRAYSORT ( stem[, first] [, n] [, sort controls] ) 

where sort controls can be up to 10 occurrences of 
[start] [, length] [, order] [, type] 

Returns 1 if sort is successful; otherwise, returns 0. Stem 
indicates the name of an integrally-indexed REXX 
compound variable to be sorted. First, with a default of 
1, represents the number of the element at which the 
sort is to begin and n, with a default of the number of 
elements from first up to the first uninitialized entry. 

Start (default 1) indicates the position within the array 
element of the sort field. 

Length (default 100) is the length of the sort field. 

Order can be A for ascending or D for descending 
sequence. 

Type can be C for case-sensitive character based fields 
for sort purposes, I for case-insensitive character based 
fields for sort purposes, or N for a numeric based fields 
for sort purposes. 

ASIN( angle ) 

Returns the inverse of the sine of angle (expressed in 
radians in the range of -n/2 to ir/2). Angle must be a 
real number in the range -1 <: angle < 1 otherwise, 
'NAN' (Not A Number) is returned. ° 

ATAN( angle ) 

Returns the inverse of the tangent of angle (expressed in 
radians in the range of -n/2 to n/2). Angle must be a 
real number in the range -1 <: angle < 1 otherwise, 
'NAN* (Not A Number) is returned. ° 

ATAN2 ( x, y ) 

Returns the inverse of the tangent of xfy (expressed in 
radians in the range of -n/2 to n/2). If both x and y are 
0, 'NAN' (Not A Number) is returned. ° 

CHARSIZE() 

Returns the height of the character mode text box. ° 
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COS( angle ) 

Returns the cosine of angle (expressed in radians). ° 

C0SH( angle ) 

Returns the hyperbolic cosine of angle (expressed in 
radians). ° 

CURSOR ( [row][, col] ) 

Returns the current cursor position on the screen as two 
whole numbers, row and column 0 , and optionally moves 
the cursor to the position specified in row and coL The 
first column of the first row is returned as 1 1. Similar in 
function to SysCurPos (page 42). 
Example: 4 1 

CURSORTYPE( [start], [end], [visibility] ) 

Returns the current cursor type before replacing the 
cursor with one which begins at start and ends at end 
pixel lines within the character box. 

Visibility can be 1 to make the cursor visible or 0 to 
make it invisible. If omitted, cursor visibility does not 
change. 

CVC0PY( fromjjtem, to_stem ) 

Returns 1 if the elements of the compound variable 
from_stem are successfully copied to tostem; otherwise, 
returns 0. 

CVREAD( fileid, tostem ) 

Returns 1 following the successful read of filejd, a file 
containing the elements of a compound variable and 
created with CVWRITE. The elements are read into 
tojtem. File id must be a fully qualified file name. 

To stem is initialized prior to the read occurring. 

CVSEARCH( stem, tail_stem, pattern[, options] ) 

Returns the number of tail elements (those following the 
first 7) in stem which are placed into tailjtem as a result 
of searching stem with pattern. Options can be 'C (non- 
default) to indicate a case sensitive search. ° 

See the REXXLIB User's Guide for a description of 
pattern. 
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CVTAILS( stem, tail_stem[, pattern] [, options] ) 

Returns the number of tail elements (those following the 
first 7) in stem which are placed into tailjtem. If patten 
is used to select tails, only the tail portion of th« 
compound variable is used for matching. Options can 
'C (non-default) to indicate a case sensitive search. ° 

See the REXXLIB User's Guide for a description o: 
pattern, 

CVWRITE( filejid, fromj»tem ) 

Returns 1 indicating the fromjtem has been successful^ 
written to filejd; otherwise, returns 0. Filejd must be * 
fully qualified file name. 

DATEC0NV( date[, inputjformat[, outputjformat] ) 

Returns a converted date, which is in input Jorma 
format (B, C, D, E, J, N, O, S, or U), to output Jorma 
(B, C, D, E, J, M, O, S, U or W). The formats are the 
same as those used for the DATE() built-in functioi 
(page 21 for a description of these formats). 

DELAY ( duration ) 

Returns 1 after suspending execution for duratior 
seconds, which can be a fraction. Suspension o 
execution is accurate to about one tenth of a second 
Functionally equivalent to SysSleep() (page 57); 

DETAB( string [, space_count] ) 

Returns string with all tab characters ('09x) removed am 
replaced with an appropriate number of spaces 
Space _count t with a default value of 8, represents thi 
number of spaces between tab stops. 

Notes: Tab diameters are often inserted in ASCII date 
files by text editors and are also common in file, 
transferred from Unix systems. Unlike Unix, OS/1 
does not ordinarily equate tabs to spaces, so i 
may be necessary to remove them with DETAB 

D0SAPPTYPE( filejd ) 

Returns 3 words, each containing a whole number 
indicating the type of executable file filejd is. Return 
0 0 0 for a non-executable file. 
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Word 1: 

0 - application type not specified in file. 

1 - program is OS/2 full-screen only. 

2 - program can execute in PM text-mode window. 

3 - application is a PM program. 
16 - program is a DLL. 

32 - program is DOS only. 



Word 2: 

1 - indicating that the program has been "bound"; 
otherwise, returns 0. 



Word 3: 

1 - indicates the application is a 32-bit program; 
otherwise, returns 0. 



D0SB00TDRIVEO 

Returns the one character disk letter, in uppercase, of 
the system boot drive. 

D0SCD( [drivejetter] ) 

Returns the name of the current directory on drivejetter 
or on the current drive . Returns a null string if 
drivejetter is not available. 

D0SCHDIR( pathjiame ) 

Returns 1 if the current directory on a particular drive 
is successfully changed to pathjutme; returns 0 
otherwise. 



D0SCHM0D( filejiame[, turnj>n[, turn_off] ) 

Returns 1 indicating that attributes of the fully qualified 
file name have been successfully changed; returns 0 
otherwise. 

Turn j>n and turnj>ff represent strings containing the 
letters Hidden, System, Read-only or Archive which are 
the only .attributes which can be changed with 
DOSCHMOD. 

DOSCOMMANDFIND ( command_f i 1 e ) 

Returns the fully qualified name of command Jile if it is 
located in the current directory or system path; 
otherwise, returns a null string. 
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If either a drive or directory is included in command Jile, 
then only that drive or directory is searched. A file is 
considered a command file if it has an extension of 
^ .COM, .EXE or .CMD and a match is found in the same 
priority. 

D0SC0PY( sourcejiame [ t target_name] 

- [, mode][, options] ) 

Returns 0 if sourcejiame is successfully copied to 
target _name\ otherwise, returns an error code. Possible 
error codes include: 

2 source file not found 

3 source or target path not found 

5 target file exists but 'A' or 'R' mode not 
specified 

32 sharing violation for source or target file 
108 source or target drive locked 
112 disk full 

206 invalid source or target file name 

267 source name is a directory 

282 extended attributes not supported for target 

Mode is a letter ('R', 'A', or 'N') which indicates whether 
the target file, if it already exists, should be Replaced, 
Appended, or left unchanged. 

Options contains a string consisting of one or more of 
the following: 

V Verity the data after copying and indicate an 
error if the copied data does not match. 

If the target of the copy operation is not specified, it is 
a file in the current directory having the same name as 
the source of the copy. 

Wildcard characters ( '*' and ) are not allowed in the 
source or target names. 

By default, a copy fails if the target already exists. This 
is a mode of 'N'. If the mode is 'A', and the target exists, 
the data from the source is appended to the target. If 
the mode is 'R' and the target exists, it is replaced. If the 
target is read-only, the copy fails regardless of mode. 
Attributes of the source ( last modification date, etc. ) 
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are copied to the target unless the target already exists 
and is being appended. 

Extended attributes are copied from the source to the 
target unless the target already exists and is being 
appended. If the volume that holds the target does not 
support extended attributes ( e. g. a floppy ), the data 
will be copied without extended attributes. 

It may be faster to use the DOSCOPY function instead 
of the system COPY command if the default execution 
environment is not CMD.EXE, since the need to start a 
new process can be avoided. It is also safer, since unlike 
the COPY command, DOSCOPY does not replace an 
existing target unless explicitly requested to do so. 

If an error occurs during copying, the target file is 
deleted, unless it was being appended, in which case it is 
restored to its original size. 

D0SCREAT( filejiame ) 

Returns 1 if file name is successfully created. When 
file_name is created or, if filejiame already exists, its 
length is set to zero. 

D0SDEL( filejiame ) 

Returns 1 if filejiame is successfully deleted; returns 0 
otherwise. Functionally equivalent to SysFileDeleteQ 
(page 44). 

D0SDIR( [file_id][, output] [, search] [, mask] - 

- [, position] 

Returns the directory information described below for 
filejd or a null string if filejd is not located. 

If filejd contains drive or path information, the specified 
drive or directory is searched; otherwise, the current 
drive of the current directory is searched. If filejd 
contains wildcards, the first matching file is located. If 
filejd is omitted, it is assumed that a previous call was 
made to DOSDIR specifying a filejd with wildcard 
characters, and the next matching file is found. 

The returned string contains: 
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• The name and extension of filejd in the format 
filename.ext. 

• The size of filejd in bytes. ° 

• The date of the last update of filejd in the form 
mm/dd/yy. 

• The time of the last update of file jd in the form 
hh:mm:ss. 

• An ordered group of characters indicating the file 
attributes associated with filejd The presence of the 
respective character indicates the attribute is set; 
otherwise, the position contains a dash. 

R read-only 
H hidden file 
S system file 
D directory entry 
A archive bit is set 

none of the above attributes is set 

Example: 0S2.INI 115520 09/29/93 12:28:42 RA 
EDIT.CMD 2526 01/11/93 12:29:00 - 

If output is omitted or is null, all of the above 
information is returned by DOSDIR; otherwise, output 
can contain any of the following letters, in any order, 
which result in just the specified fields to be returned 
and in the same order as the respective letters specified 
in output. 

N filejd's name and extension are returned 

S filejd's size is returned 

D filejds date is returned 

T filejd's time is returned 

A file id's attribute string is returned 

If source is omitted or null, DOSDIR searches only 
for "normal' files. Hidden files, system files and 
directory files are ignored. Search can contain an 
unordered string of the following characters that 
cause the respective additional entries to be 
included in the search: 

H hidden files are included 
S system files are included 
D directoiy files are included. 
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If filejd is not specified and DOSDIR is searching 
for the next match of a previously-specified pattern, 
search is ignored. 

R restricts the search to read-only files 
H restricts the search to hidden files 
S restricts the search to system files. 
D restricts the search to directory files 
A restricts the search to files with the archive bit 
set 

With filejd omitted, DOSDIR normally searches for the 
next file which matches the last used pattern. The 
position operand can be used to cause a search for the 
next file matching a previously used pattern, allowing 
intervening calls to DOSDIR using other patters. The 
DOSDIRPOS function is used to save the current 
position in a directory search. 

D0SDIRCL0SE( position ) 

Returns 0 if DOSDIR is successfully notified that a file 
search is complete; otherwise, returns 1. 

DOSDIRPOS () 

Returns a string representing the current DOSDIR 
directory position status. A later call to DOSDIR can 
specify the status via its position argument to resume 
processing a directory search at the current position. 

D0SDISK( option[, drivejetter ) 

Returns information about drivejetter or the current 
drive if drive jetter is omitted; otherwise, returns -1 if 
drivejetter is invalid. The information returned is 
dependent on option. 

A The number of available clusters on the disk. 

B The number of bytes per disk sector. 

C The number of clusters on the disk. 

F The number of free (unused) bytes on the disk. 

S The number of sectors per disk cluster. 

T The total number of bytes on the disk. 

U The total number of bytes in use on the disk. 
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DOSDRIVE( newjirivejetter ) 

Returns the letter of the current drive before optionally 
establishing new jtrive letter as the current default drive. 

DOSEALIST( file_id[, name_stem[, value_stem] - 

- [, flag_stem] ) 

Returns the number of extended attributes that exist for 
file-name. -1 is returned \ifilejd does not exist or if an 
error occurs retrieving the extended attributes. ° 

Namestem is the name of a compound variable which 
receives the name of the extended attribute. Value stem 
is the name of a compound variable which receives the 
value of the extended attribute. Flagjtem is the name of 
a compound variable which receives the flag byte of the 
extended attribute. 

DOSEASIZE( filejid ) 

Returns the total size of the extended attributes 
belonging to filejd or -1 if file id does not exist or an 
error occurs retrieving the extended attributes. ° 

DOSEDITNAME( source, pattern ) 

Returns a file name character string based on source and 
pattern. Characters are copied, one at a time, from 
pattern to the result string. Each character in pattern 
copied causes a pointer to advance in source. The 
operation stops when pattern is exhausted. 

If '?' is found in pattern, the current character in source 
is copied unless a period or the end of source has been 
encountered. 

If '*' is found in pattern, characters in source are copied 
until the character following the in source is reached 
or source is exhausted. 

If 7 is found in pattern, the source pointer is advanced to 
the character following the 
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DOSENY( environment_variablejiame ) 

Returns the value associated with 
environment ^variable jiame or a null string if 
environment _yariable name is not found. Functionally 
equivalent to the VALUE() function with 
0S2ENVIR0NMENT specified as the selector (page 
32). 

DOSENVLIST( list_stem ) 

Returns the number of OS/2 environment variables. 
Each environment variable is copied to list stem, 

DOSENVSIZEO 

Returns two whole numbers indicating the total size of 
the current environment area and the number of free 
bytes in the current environment area. ° 

D0SFDATE( file_id[, new_date] [, new_time] ) 

Returns 1 if new date and/or newjime have successfully 
replaced the date/time indicating the last update of 
filejd; otherwise, returns 0. Newjiate is specified in the 
"sorted" date format (DATE('S') - see page 21) and must 
be specified as 8 digits, without punctuation, and 
represents yyyymmdd.NewJime must be 6 digits and 
represents hhmmss (TIME('N') without colons). 

DOSFILEHANDLES( [handles] ) 

Returns the maximum number of system file handles 
that may be opened in a given process and optionally 
changes the number to handles. Similar in function to 
SysAddFileHandle (page 37). 

Note: File handles are used every time a file is accessed 
with REXX HO functions such as CHARIN I 
CHAROUT, LINEIN I LINEOUT, CHARS, 
LINES, and STREAM. Other services invoked 
indirectly from REXX (e.g. SysGetMessageQ or 
other API routines) may also create open file 
handles. At least 3 handles are usually in use for 
the standard input stream, standard output, 
stream, and standard error stream. 
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DOSFILEINFO( fileid, option ) 

Returns the following depending on option: 

A Returns the date and time the file was last accessed 
C Returns the date and time the file was created. 
S Returns the allocated size of the file. ° 

Date and time are returned as two words in the form 
nim/dd/yy hh:mm:ss. Options A & C are only valid foi 
HPFS disks. If file Jd specifies a file on a FAT disk an< 
option is either A or C, the string returned is: 00/00/8C 
00:00:00. 

D0SFILESYS( [dri vej etter] , ) 

Returns 'FAT', 'HPFS', 'CDFS' or 'LAN' indicating th* 
file system on drive Jetter or on the current drive i; 
drive letter is omitted. LAN is returned for all pee] 
drives on Warp Connect. Functionally equivalent tc 
SysFileSystemType() (page 45). 

D0SFNAME( filename ) 

Returns the fully qualified name of file name including 
drive, path, name and extension for file name on the 
current or specified directory or a null string if filejianu 
is invalid. 

D0SFSIZE( filejd, [new_size] ) 

Returns the actual size of the fully qualified fdejd 
optionally changing the size of file id to new-size, 
Returns -1 if filejd does not exist. ° 

D0SISDEV( filejiame ) 

Returns 1 if filejiame is a device name such as: CON, 
PRN, LPT1, NUL, etc.; otherwise, returns 0. 

D0SISDIR( filejd ) 

Returns 1 if filejd represents an existing directory; 
otherwise, returns 0. 

Note: Filejd should not contain a trailing slash. 

D0SISFILE( filejd ) 

Returns 1 if file id represents an existing file. Returns 0 
if filejd does not exist, is a device or is a named pipe. 
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DOSISPIPE( filename ) 

Returns 1 if file jmme represents an existing named pipe; 
otherwise, returns 0. 

D0SKILLPR0CESS( pid[, option] ) 

Returns 1 if the system successfully flagged the process 
identified in pid for termination; otherwise, returns 0. An 
option of T' indicates that there is no restriction on the 
process to be terminated. An option of T indicates the 
pid must be the current process or one of its 
descendants. 

DOSMAKEDIR( pathjiame ) 

Returns 1 if the directory specified in path name is 
successfully created or currently exists; otherwise, returns 
0. This function differs from SysMkDir and DOSMKDIR 
in that it will create any necessary intermediate 
directories. 

DOSMAXPATH () 

Returns the maximum acceptable length of a fully 
qualified path name. 

DOSMKDIR ( pathjiame ) 

Returns 1 if the fully qualified pathjuime results in the 
successful creation of the named directory. Functionally 
equivalent to SysMkDir() (page 49). 

DOS PATH FIND( filejiame [, environment] ) 

Returns the fully qualified name otfile name; otherwise, 
returns a null string. Environment, with a default of 
PATH , indicates an environment variable which contains 
a list of directories. DOSPATHFIND will not use 
LIBPATH since it is not an environment variable. 
Functionally equivalent to SysSearchPathQ (page 56). 

D0SPID() 

Returns the process id (PID) of the current process. 
This is a number which uniquely identifies the process 
within the system. 
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DOSPIDLIST( pid_stem[, name_stem[, parent_stem - 

- [, session_stem] ) 

Returns the number of processes found and placed intc 
the compound variable pidjstem. ° 

Namejtem is a compound variable that receives the 
names of these processes. Parent stem is the name of the 
compound variable which receives the list of parent 
process identifiers. Sessionstem is the name of a 
compound variable that receives the list of session 
identifiers. 

D0SPRI0RITY( [delta], [class], pid ) 

Returns two whole numbers indicating the priority level 
and the priority class of thread 1 of the process specified 
in pid. If pid indicates a descendant of the requesting 
task, the delta and class can be specified to alter the 
current values. Functionally equivalent to 
SysSetPriorityO (page 57). 

Delta is a signed number from -31 to +31 that indicates 
the requested change to priority. 0 indicates no priority 
change is to occur. 

Class is a number from 1 to 4 indicating a new priority 
class. 

D0SPR0CINF0( option [, pid] ) 

Returns information about pid depending upon option. 
If pid is omitted, information is returned for the current 
process. 

N Returns the fully qualified name of the program 

associated with pid. 
P Returns the process identifier of the parent process. 
S Returns the session identifier of the process. 

DOS RENAME ( f il ejiame_l, filejiame_2 ) 

Returns 1 if fde_name_l , which must contain a fully 
qualified file or directory name, is successfully renamed 
to the new name in file_?iame_2; otherwise, returns 0. 
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DOSRMDIR( di rectory jiame ) 

Returns 1 if directory name is successfully removed; 
otherwise, returns 0. Functionally equivalent to 
SysRmDir() (page 55). 

D05SESSI0NTYPEO 

Returns a number indicating the type of session the 
function was invoked in. Functionally equivalent to 
SysProcessTypeQ (page 52). 

0 - full-screen. 

2 - VIO window 

3 - PM session 

4 - detached session 

DOSSWITCHLIST( tit! eastern [, pid_stem] - 

- [, session_stem] [, hand! e_s tern] - 

- [, type_stem] [, visibil ity_stem] ) 

Returns a whole number indicating the number of switch 
list entries found and places information about the 
sessions in the system "switch list" (Window list) into one 
or more compound variables. 

Title stem: A stem name for the compound variable 
that receives the title of the session. 

Pidstem: A stem name for the compound variable 
that receives the list of process identifiers. 

Session stem: A stem name for the compound variable 
that receives the list of session identifiers. 

Handle jtem: A stem name for the compound variable 
that receives the list of window handles. 

Typejtem: A stem name for the compound variable 
that receives the list of program types. 

Visibility jtem: A stem name for the compound 
variable that receives the list of 
visibility flags. 

Not all processes listed by DOSPIDLIST() will be 
returned by DOSSWITCHLIST(). Only those processes 
which are included in the switch list are returned. 
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Conversely, not all processes listed by 
DOSSWITCHLISTQ will be returned by 
DOSPIDLIST(). For instance, processes corresponding 
to DOS or Windows sessions are not shown by 
DOSPIDLIST(). 

The session title is the string that occurs in the title bar 
of the session's window and in the switch list. All "white 
space" characters between words in the title are 
removed, except for a single blank. 

Element 0 of each compound variable array is set to the 
number of elements in the array. 

The program type is a number which indicates the type 
of the session. It may be: 



0 - OS/2 full screen 

2 - OS/2 window 

3 - PM application 

4 - DOS or Windows full screen 
7 - DOS or Windows window 

The visibility flag is a number that indicates whether the 
item is actually visible in the switch list. It may be: 

1 - invisible 

2 - grayed 

4 - fully visible 



DOSTEMPNAME( name_pattern ) 

Returns a valid file name, unique to the current or 
default drive, derived from pattern', otherwise, returns a 
null string if a unique name can not be created. 
Functionally equivalent to SysTempFileNameQ (page 
58). 

D0STID( ) 

Returns the thread id (TID) of the current thread. This 
is a number which uniquely identifies the thread within 
the current process. 

D0SV0LUME( [drivejetter] ) 

Returns the volume label of drivejetter or the current 
drive . If a disk is unlabeled, a null string is returned. 
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DOSVOLINFO( [disk], [option] ) 

Returns information about a specified disk volume. Disk 
is the letter that identifies the disk for which information 
is requested. Default is the current disk. Option is a 
letter that indicates the type of information, which can 
be: 

F File system type (e. g. FAT, HPFS, CDFS, LAN). 

L The volume label. 

S The volume serial number (default). 

Note: The volume serial number is a unique identifier 
created when the volume is formatted. It is 
returned in the form xxxx-xxxx, where x is a hex 
digit. 

The volume label is the user-specified identifier 
associated with the volume by the FORMAT 
or LABEL command. This is the same 
information returned by DOSVOLUME. 

The file system type is the same information 
returned by DOSFILESYS. 

ENTAB ( string, [space jrount] ) 

Returns string with space count consecutive blanks in 
string replaced with tab characters ('09'x). Space count 
defaults to 8. 

Note: Replacing blanks with tabs can make some 
strings considerably shorter. This may be 
significant when creating large ASCII TEXT files. 

ERF( x ) 

Returns the error function (2n m ft e 1 " 2 dt). ° 
ERFC( x ) 

Returns the complement of the error function 
(1 - ERF(x)). ° 
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EVENTSEM_CLOSE( name ) 

Returns 0 if event semaphore name is successfully 
closed; otherwise, a return code identifying the type of 
error. 

Note: This function should be used when you are done 
with an event semaphore to release associated 
storage resources. 

EVENTSEM JREATE( name[, options] ) 

Returns 0 if event semaphore name was successfully 
created; otherwise, a return code identifying the type of 
error. An option of 'P' (non-default) causes the 
semaphore to be created in a "posted" state. 

Note: This function should be invoked once and only 
once to define the event semaphore to the system. 

When an event semaphore is in the posted state, 
the event that it represents is considered to have 
occurred and EVENTSEM WAIT will not wait. 

EVENTSEM_POST( name ) 

Returns 0 if event semaphore name is successfully 
posted; otherwise, a return code identifying the type of 
error. 



Note: When an event semaphore is in the posted state, 
the event that it represents is considered to have 
occurred and EVENTSEM WAIT will not wait. 

EVENTS EM_QUERY( name ) 

Returns the number of times event semaphore name has 
been posted since it was last reset. If an error occurs, a 
negative number is returned that identifies the type of 
error. 
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EVENTSEM_RESET( name ) 

Returns the number of times event semaphore name has 
been posted since it was last reset if the operation was 
successful; otherwise, a negative number is returned that 
identifies the type of error. 

Note: Wlien an event semaphore is reset, the event it 
represents is considered not to Iiave occurred and 
EVENTSEM WAIT will wait. 

EVENTSEM_WAIT( name[, timeout] ) 

Returns 0 after event semaphore name is posted; 
otherwise, returns a code identifying the type of error. 
Return does not occur until timeout milliseconds have 
elapsed. The default for timeout is -1 indicating an 
indefinite wait. 

EXP( x ) 

Returns the exponential function of x - the value of e* 
(e=2.718281828...). ° 

FILECRCf filename ) 

Returns the 32-bit CRC (cyclic redundancy check) for 
file name as 8 characters. 

FILEREAD( filejiame, stem[, count] [, option] - 

- [, line_end[, start pos] ) 

Returns the number of lines read from file name and 
placed into the compound variable stem. A negative 
return code indicates an error reading the file (e. g. 
invalid name, file not found). 

The presence of count results in count lines being read 
rather than the entire file. The option, E, will result in 
the read stopping if an end-of-file character (lAx) is 
encountered. ° 

Line_end defines the string used to determine the end of 
a line and can be one of the following: 

LFONLY Line feeds and carriage return - line feed 
pairs. 

CRONLY Only carriage returns and carriage return 
- line feed pairs. 
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CRORLF Line feeds, carriage returns, or carriage 

return - line feed pairs. 
CRANDLF Only carriage return - line feed pairs. 

Start j>os indicates the relative position in the file at 
which to begin reading. (The first byte of the file is 1.) 

Note 01: Element 0 of the compound variable array 
(stem) is set to the number of lines read. 

Note 02: There is no particular limit on the length of any 
line which may be read. 

FILESEARCH( filejiame, pattern, stent, options] - 

- [, zonel][, zone2][, count] - 
[, line_end][, start_pos] ) 

Returns the number of lines from filejiame which, as a 
result of matching pattern subject to options, are placed 
into stem. A negative return code indicates an error 
reading the file (e. g. invalid name, file not found). ° 

Pattern is the regular expression pattern that describes 
the search string. Options can be one or more of: 

A - Avoid; select only lines which do not match pattern. 
C - Case sensitive matching (non-default). 
N - Number. Precede each line with its relative line 
number. 

E - EOF sensitive. The search will stop if an end-of-file 
character (lA'x) is encountered. 

Zonel and zone2, with a default of 1 and end-of-line 
respectively, define the scope of the search argument in 
each line. Count indicates the number of lines to search. 
The default is the whole file. 

Lifje_end defines the string used to determine the end of 
a line and can be one of the following: 

LFONLY Line feeds and carriage return - line feed 
pairs. 

CRONLY Only carriage returns and carriage return 

- line feed pairs. 
CRORLF Line feeds, carriage returns, or carriage 

return - line feed pairs. 
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CRANDLF Only carriage return - line feed pairs. 

Start jpos indicates the relative position in the file at 
which to begin reading. (The first byte of the file is 1.) 

Note 01: Element 0 of the compound variable array 
(stern) is set to the number of lines read. 

FILEWRITE( filejiame, stem[, option] [, count] - 

- [. start] ) 

Returns 1 if the contents of the compound variable stem 
is successfully written to file name as an ASCII file. 
Count and start have the respective defaults of the 
number of elements in the compound variable and 1. 
Option can be one of the following: 

A - Append the file, if it exists. 
R - Replace the file, if it exists. 
N - Nothing is to occur if the file exists. 

Note: The file is closed after each call to the function. 

GAMMA ( x ) 

Returns the gamma function for jc>0 or a null string for 
x*0. ° 

GREP( pattern, string [, options] ) 

Returns two numbers, separated by a blank, which 
represent the position in string and the length of the 
substring matched by pattern or 0 0 if there is no match. 
Pattern is a regular expression pattern and option can be 
'C indicating a case sensitive (non-default) search. ° 

INKEY( [wait_option[, keyboard_option] ) 

Returns an encoded string that represents which key was 
pressed. A list of all of the possible combinations of keys 
and the data returned by this function for each key is 
listed in Appendix B (page 211). Functionally equivalent 
to SysGetKey() (page 47). 

Wait option is either Wait or No wait for a key to be 
pressed. If no wait is specified and a key has not been 
pressed, a null string is returned. 
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Keyboard option, with a default of F indicates that keys 
with dual representation (i.e. the leading byte of the 2 
byte scan code is 'EO'X) are folded into the same 
representation as their other scan code (i.e. the leading 
byte is changed to 'OO'X). The keyboard option E will 
result in the exact scan code being returned. 

L0G( x ) 

Returns the natural logarithm ofx forx>0; INFINITY' 
forx=0; or 'NAN' (Not A Number) for x<0. ° 

L0G10( x ) 

Returns the logarithm (base 10) of x for x>0; 
INFINITY' forx=0; or 'NAN' (Not A Number) for x<0. 

o 

L0WER( string ) 

Returns string in lowercase. 

MACR0ADD( function, file__name[, position] ) 

Returns 1 if function is successfully added to the 
macrospace; otherwise, returns 0. File name is the fully 
qualified name of the REXX program file. Position is 
either B, indicating that the macrospace should be 
searched before the list of registered functions and 
functions on disk; or, A indicating that the macrospace 
should be searched after a search is made of registered 
functions and functions on disk. 

MACR0CLEAR() 

Returns 1 indicating that the macrospace has been 
cleared of all REXX procedures; otherwise, returns 0. 

MACR0DR0P( function ) 

Returns 1 if function is successfully removed from the 
macrospace; otherwise, returns 0. 

MACRO LOAD ( file_name[, name_stem] ) 

Returns 1 if some or all of the named functions in the 
compound variable, name stem, and located on the saved 
macrospace file, file name, are successfully loaded to the 
macrospace. 
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If name _s tern is omitted, all functions in filejwme are 
loaded. If name _s tern is present, name stem. 0 must 
contain the number of procedure names in the array. 

MACROQUERY( function ) 

Returns B if the function search position in the 
macrospace is before external functions, A if the function 
search position is after external functions, or null if 
function is not found in the macrospace. 

MACR0RE0RDER( function, position ) 

Returns 1 if search order of function in the macrospace 
is successfully changed; otherwise, returns 0. Position is 
either B, search the macrospace before searching 
external function packages or disk files; or A, search the 
macrospace afterward. 

MACR0SAVE( filejiame[, name_stem] ) 

Returns 1 if some or all of the named functions in the 
compound variable, name stem, are successfully saved on 
the macrospace file file name. If fdejiame exists, it is 
replaced. 

liname_stem is omitted, all functions in the macrospace 
are saved to filejiame. If name _s tern is present, 
name _s tern. 0 must contain the number of procedure 
names in the array. 

MUTEXSEM_CLOSE( name ) 

Returns 0 if mutual exclusion semaphore name is 
successfully closed; otherwise, a return code identifying 
the type of error. 

MUT EXS EM_C R EAT E ( name[, options] ) 

Returns 0 if mutual exclusion semaphore name was 
successfully created; otherwise, a return code identifying 
the type of error. An option of r O' (non-default) causes 
the semaphore to be created in an "owned" state. 

MUTEXSEM_QUERY( name ) 

Returns a string of three numbers indicating: the 
number of times the mutual exclusion semaphore, name, 
has been requested by its owner less the number of 
times it has been released; the process id of the owner; 
the thread id of the semaphore owner. 
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If the semaphore is not currently owned, all three 
numbers returned will be 0 and if an error occurs, a 
negative number is returned identifying the type of error. 

MUT EXS EM_RELEAS E ( name ) 

Returns 0 if the ownership of a mutual exclusion 
semaphore, name, is released; otherwise, a number 
identifying the type of error. 

MUTEXSEM_REQUEST ( name[, timeout] ) 

Returns 0 if the ownership request for a mutually 
exclusive semaphore, name, is successful; otherwise, a 
return code identifying the type of error. Return does 
not occur until timeout milliseconds have elapsed. The 
default for timeout is -1 indicating an indefinite wait. 

NMPIPE_CALL( name, message[, max] [, timeout] ) 

Returns a string sent by the server, across pipe name, in 
response to message. Max (default 4096) is the maximum 
length of the expected reply and timeout is the length of 
time, in milliseconds, to wait for the pipe to become 
available. 

NMPIPE_CL0SE( name ) 

Returns 0 if name is successfully closed; otherwise, an 
error code. 

NMPIPE_CONNECT( name ) 

Returns 0 if a connection with name is successfully 
established; otherwise, an error code. 

NMPIPEJREATE( name[, type] [, mode] [ f wait] - 

- out][, in] ) 

Returns the pipe handle, in the form of a number, if 
name was successfully created; otherwise, a negative 
number identifying the error. 

Type: 'B' for a byte stream pipe; ! M' for a message 
pipe. 

Mode: Read mode if the pipe is message pipe: 

'B' if the read mode is byte; 'M' if the read 
mode is message. 

Wait: W if reads should block waiting for data; 'N' if 
reads should not block. 
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Out and in indicate the size, in bytes, of the output and 
input buffers, respectively (default 4096). 

NMPIPE_DISCONNECT( name ) 

Returns 0 if the server was able to terminate a 
communication session with name; otherwise, returns an 
error code. 

NMPIPEJPEN( name[, mode] [, wait][, in] ) 

Returns 0 if a communication session with name was 
opened successfully; otherwise, returns an error code. 

Mode: Read mode if the pipe is a message pipe: 

'B' if the read mode is byte; 'M f if the read 
mode is message. 

Wait: W if reads should block waiting for data; 'N' if 
reads should not block. 

In indicates the size, in bytes, of the input buffer (default 
4096). 

NMPIPE_READ( name[, count] ) 

Returns the data string from the pipe name. The number 
of bytes to be returned can be specified in count or will 
default to the pipe's input buffer size. 

NMPI PEJTRANSACT ( name, message [, max] ) 

Returns a data string sent by the server in response to 
message. The max size of the reply expected, with a 
default of 4096. 

NMPIPE_WRITE( name, data ) 

Returns the number of characters of data not written to 
name. A negative return code indicates an error. 

PARS E FN ( filename ) 

Returns a string consisting of 4 uppercase words 
resulting from parsing fUejwme: 

Drive letter (no colon) 
Path specification 
file name 
file extension 
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Components not present are replaced with a dash 
Filejmme is not checked for validity, just for syntactical 
correctness. Similar in function to FILESPEC (page 22). 
Example: C \ABC\ XYZ EXT 

PCC0PR0CESS0RO 

Returns 1 if a hardware math coprocessor exists; 
otherwise, returns 0. 

PCDISK( optionf, drivejetter] ) 

Returns information, depending upon option, about a 
fixed or floppy disk drives indicated in drivejetter, or the 
current drive. 

N Returns the number of fixed and floppy drives. 
H Returns the number of heads (read-write surfaces) 

(i.e. the number of tracks per cylinder). 
C Returns the number of disk cylinders. 
S Returns the number of sectors per track. 

A drive letter can only be specified for the H, C, and S 
functions and these options only apply to hard disks. 

PCFLOPPYf) 

Returns the number of floppy drives installed. 
PCM0DEL() 

Returns the system (BIOS) defined model number. 
Example: 252 

PCPARALLELQ 

Returns the number of parallel ports installed. 

PCRAM() 

Returns the number of IK (1,024 bytes) of RAM 
(random access memory - real storage) installed. 

PCSERIAL() 

Returns the number of serial ports installed. 

PCSUBM0DELO 

Returns the system (BIOS) defined submodel number. 
Example: 1 
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PCVIDEOMODEQ 

Returns 4 numeric words which describe information 
about the current screen mode. Word 1 is 1 if the 
function is successful otherwise word 1 is -1. 

Word 2 is the number of bits of color information which 
can be displayed for each pixel. 

Words 3 and 4 contain the horizontal and vertical 
resolution of the current screen in pixels. 
Example: 1 4 720 400 

P0W( x, y ) 

Returns the value of x raised to the y power (x y ) if x is 
non-negative and y is an integer; otherwise, returns 
'NAN' (Not A Number). ° 

PMPRINTF( string ) 

Returns 1 after writing string to the PMPRINTF window. 

Note: You must have the PMPRINTF program to use 
this function. The PMPRINTF program is started 
in a separate window just like any other OS/2 
application. The PMPRINTF program is IBM 
EWS (Employee Written Software) that is 
available from many OS/2 Bulletin Boards and 
information services. It can also be found on the 
OS/2 Warp Version 3 Unleashed companion 
CD-ROM (ISBN 0-672-30545-3). 

REXXLIBDEREGISTERO 

Returns 1 and removes the definitions of all REXXLIB 
functions from the operating system. 

REXXLI BREGISTER () 

Returns 1 and defines all REXXLIB functions to the 
operating system. 

REXXLI BVER() 

Returns the current REXXLIB version number. 
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REXXRUN( type, source [, result] - 

- [. arg-l]...[. arg-n] } 

Returns the return code from the REXX interprets 
resulting from running an external REXX program fron 
a file, the REXX macrospace, a source code string, or i 
tokenized source code string. This will be 0 if the 
program ran to completion. A positive number indicate: 
a problem starting the interpreter. A negative number ii 
a program execution error (the negative of the REX> 
error code - see Appendix D on page 215). 

Type is the type of source code, which can be: 

F - Source code is in a file. 

S - Source code is in a string. 

T - Source code is in a tokenized string. 

M - Source code is in the macrospace. 

Source depends on the value of type. For each typ< 
below, source can be: 

F - the actual program code 

S - source code in a string 

T - tokenized source code 

M - the name of a function in the macrospace 

Result is the name of a REXX variable to receive th< 
value returned, if any, by the program. 

Arg-i are the arguments to be passed to the program. 

Source code may be supplied in a REXX string (typ< 
'S'). This should be in a form just as if the program wer< 
read from a file, with lines separated by carriage return 
and line feeds, and statements on the same lim 
separated by semicolons. 

Tokenized code is created as the output of th< 
TOKENIZEFILE or TOKENIZESTRING functions. 

Programs are loaded into the macrospace with th< 
MACROADD or MACROLOAD functions. 

A variable name may be specified to receive the valu 
returned by the external program. If no value i 
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returned, the variable will be dropped. Avoid using a 
variable named RESULT, since this variable is set by 
REXX itself after a CALL statement. 

There are several other ways to invoke external REXX 
programs, but all have disadvantages that are avoided by 
using REXXRUN. 

One way is to use the system CALL command. This has 
the disadvantage that it requires the system command 
handler (CMD.EXE), which means the new program 
must run in a separate process if the calling program 
wasn't started by CMD.EXE. There is an additional 
disadvantage that only one argument string can be 
passed this way. 

Another way is to use the REXX CALL statement. This 
has the disadvantage that it cannot take a variable file 
name (without using INTERPRET). In addition, if the 
called program fails because of a REXX error, a 
SYNTAX condition will be raised in the calling program. 

A final way is to use the REXX macrospace. One 
possible disadvantage of this is that the macrospace is 
global to the system, raising possibilities of name 
conflicts. 

REXXTHREADf type, source[, arg- !],•••[, arg-n] ) 

Returns the thread id of a newly created thread, or 0 if 
the thread could not be started. 

Type is the type of source code, which can be: 

F - Source code is in a file. 

S - Source code is in a string. 

T - Source code is in a tokenized string. 

M - Source code is in the macrospace. 

Source depends on the value of type. For each type 
below, source can be: 

F - the actual program code 

S - source code in a string 

T - tokenized source code 

M - the name of a function in the macrospace 
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Arg-i are the arguments to be passed to the program. 

Source code may be supplied in a REXX string (type 
'S'). This should be in a form just as if the program were 
read from a file, with lines separated by carriage returns 
and line feeds, and statements on the same line 
separated by semicolons. 

Tokenized code is created as the . output of the 
TOKENIZEFILE or TOKENIZESTRING functions. 

Programs are loaded into the macrospace with the 
MACROADD or MACROLOAD functions. 

Because the new program is run on a different thread 
there is no direct way to access a value returned by the 
program. Any exchange of data between threads mus 
use some form of inter-program communication such a 
REXX external data queues or named pipes. 

SCRBLINK( [state] ) 

Returns the current state of video attribute handling 
(blink flag) and optionally changes it to state. State cai 
be either 1 (blink) or 0 (high intensity backgroun< 
colors). Appendix C, on page 214, contains a list of th< 
video attributes. 

SCRBORDER( [color] ) 

Returns the existing color attribute of the screen borde 
and uses color to establish a new screen border attribute 
Color can be: 

0 - black 4 - red 

1 - blue 5 - magenta 

2 - green 6 - brown 

3 - cyan 7 - white 

SCRCLEAR( [attr][, char] [, row] [, column] - 

- [, height] [, weight] 

Returns 0 after clearing the entire screen, or an 
rectangular portion of the screen. Similar in function t 
SysCls (page 39). 

The display attr, with a default of 7, is used to clear th 
area. 
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The char, with a default of blank, is used to clear the 
area. 

The top row, with a default of 1, of the area to be 
cleared. 

The left-most column, with a default of 1, of the area to 
be cleared. 

The height, in rows, of the area to be cleared. Default is 
to the bottom of the screen. 

The width, in columns, of the area to be cleared. The 
default is the right edge of the screen. 

Appendix C, on page 214, contains a list of the video 
attributes. 

SCR0LLD0WN( n[, pad] [, attr] - 

- [• top][, left][, bottom] [, right] ) 

Returns 1 and scrolls text downward for n rows in a 
rectangular region of the screen defined by top, left, 
bottom, and right. Pad (default blank) indicates the 
character, along with attr (default white on black), to be 
applied to the rows inserted into the top of the 
rectangular region. Appendix C, on page 214, contains 
a list of the video attributes. 

SCROLLLEFT( n[, pad] [, attr] - 

- [, top][, left][, bottom] [, right] ) 

Returns 1 and scrolls text left for n columns in a 
rectangular region of the screen defined by top, left, 
bottom, and right. Pad (default blank) indicates the 
character, along with attr (default white on black), to be 
applied to the rows inserted into the right portion of the 
rectangular region. Appendix C, on page 214, contains 
a list of the video attributes. 
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SCROLLRIGHT( n[, pad] [, attr] - 

- [, top][, left][, bottom] [, right] ) 

Returns 1 and scrolls text right for n columns in a 
rectangular region of the screen defined by top, left, 
bottom, and right. Pad (default blank) indicates the 
character, along with attr (default white on black), to be 
applied to the rows inserted into the left portion of the 
rectangular region. Appendix C, on page 214, contains 
a list of the video attributes. 

SCR0LLUP( n[, pad] [, attr] - 

- [. top][, left][, bottom] [, right] ) 

Returns 1 and scrolls text upward for n rows in a 
rectangular region of the screen defined by top, left, 
bottom, and right. Pad (default blank) indicates the 
character, along with attr (default white on black), to be 
applied to the rows inserted into the bottom of the 
rectangular region. Appendix C, on page 214, contains 
a list of the video attributes. 

SCRPUT( row, col, string[, option] ) 

Returns a null string after writing string to the screen at 
the position indicated by row and col. Option is 
Attributes, Text, or Both and indicates the contents of 
string. Appendix C, on page 214, contains a list of the 
video attributes. 

5CRREAD( row, col, length[, option] ) 

A string read from the screen at the position specified 
by row and col for a length length. Option is Attributes, 
Text, or Both and indicates what is read from the screen. 
If attributes are included, the length of the string 
returned is double the number of bytes returned when 
attributes are not included. Appendix C, on page 214, 
contains a list of the video attributes. 

SCRSIZE() 

Returns two words indicating the size of the screen (or 
window) in rows and columns. Functionally equivalent to 
SysTextScreenSizeQ (page 58). ° 
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SCRWRITE( [row][, col] [, string] [, length] - 

- [, pad][, attr] ) 

Returns 0 after writing string, with optional attr, 
beginning at row and col for length or the length of string 
to the screen. If length exceeds the length of string, pad 
is used to complete the write. SCRWRITE does not 
affect the current cursor position. Appendix C, on page 
214, contains a list of the video attributes. 

SHIFTSTATE( key,[ state] ) 

Returns the current shift state of the NumLock, 
CapsLock, and ScrollLock keys. The presence of state 
results in the state of the respective key being set. 

Key: 'C (CapsLock); 'N* (NumLock); or 'S* 

(ScrollLock). 
State: 0 to for unshifted, 1 for shifted. 

SIN( angle ) 

Returns the sine of angle (expressed in radians). ° 

SINH( angle ) 

Returns the hyperbolic sine of angle (expressed in 
radians ). ° 

S0UND( [frequency], [duration] ) 

Sounds the computer's speaker. Frequency, in cycles per 
second (Hertz) with a range of 37 to 32,767 and a 
default of 880, is rounded to the nearest integer. 
Duration is in fractions of a second with a default of 0.2 
and accuracy to within about one tenth of a second. 
Functionally equivalent to BEEP() (page 17). 

SQRT( x ) 

Returns the square root of x, a non-negative real 
number where xzO; otherwise, returns 'NAN' (Not A 
Number). ° 

STRINGCRC( string ) 

Returns the 32-bit CRC of string as an 8-digit 
hexadecimal number. 

Example: '352441C2' = STRINGCRCC 'abc' ) 

Note: A CRC (Cyclic Redundancy Check) is a number 
computed by performing a calculation involving 
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every byte of a string. The calculation is designed 
to minimize the probability that two strings 
which differ by even one byte can have the same 
CRC. 

STRINGINf [row][, column] [, string] - 

- [, length] [ f pad] [, attr] ) 

Returns the string entered into the input field, up to but 
not including the first pad character. The input operation 
is terminated by pressing the Enter key or by pressing 
the Esc key in which case a null string is returned. 



Row - Screen row number of the input field 

(default is row containing cursor). 
Column - Screen column number of the start of the 

input field (default is the column 

containing the cursor). 
String - String used as initial contents of input 

field (default is blanks). 
Length - Length of string (default is right edge of 

the screen). 

Pad - Character used to fill out the input field 

beyond the entered data (default is 
blank). 

Attr - Attribute to be used for displaying 

characters entered in the field (default is 
7, white on black). Appendix C, on page 
214, contains a list of the video attributes. 



TAN( angle ) 

Returns the tangent of angle (expressed in radians). ° 

TANH( angle ) 

Returns the hyperbolic tangent of angle (expressed in 
radians). ° 

TOKENIZEFILE( filejiame, output ) 

Returns 1 indicating that the REXX language processor 
successfully produced a tokenized program string; 
otherwise, returns 0. 

File name is the name of a REXX program file. 

Output is the name of a REXX variable that receives the 
tokenized result. 
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A tokenized program string can be used by the 
REXXRUNO and REXXTHRE AD () functions to 
execute a program without the overhead of processing 
the source code for each call. 

rOKENIZESTRING( source, output ) 

Returns 1 indicating that the REXX language processor 
successfully produced a tokenized program string; 
otherwise, returns 0. 

Source is a REXX string containing program source 
code. 

Output is the name of a REXX variable that receives the 
tokenized result. 

A tokenized program string can be used by the 
REXXRUN and REXXTHREAD functions to execute 
a program without the overhead of processing the source 
code for each call. 

Tokenized code is language processor dependent. Code 
tokenized by Personal REXX cannot be used by IBM 
REXX and vice versa. 

The source string should be in a form just as if the 
program were read from a file, with lines separated by 
carriage returns and line feeds, and statements on the 
same line separated by semicolons. 

rYPEMATIC( rate, delay ) 

Returns 1 indicating that the typematic repeat rate 
(characters per second - typically < 30) and initial delay 
(time in milliseconds - typically < 1000) were 
successfully set; otherwise, returns 0. 

If the function is invoked in a PM window, it returns 0 
indicating no change; however, if it is invoked in a full- 
screen session, it applies to all active sessions, including 
PM sessions. 

JPPER( string ) 

Returns string in uppercase. 
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VALIDNAME( filename [, wildcard] ) 

Returns 1 if filejiame is a syntactically valid file name. 
Wildcard is 1 (wild card characters are permitted) or 0 
(no wild card characters are permitted) in filejiame. 

VARDUMP( [filejiame] [, [include] [, varl] ,] ... ) 

Returns 1 indicating that the selected variables have 
been written to the fully qualified filejiame (default 
STDOUT). Include can be T or 'E', to include or exclude 
respectively, the variables named in varl - vam. 

If include is T and no variables are named, all variables 
are written to filejiame. Output will be appended to 
filejiame if it exists. 

This is intended as a debugging function. 

VARREAD( filejiame [, [include] [, varl] ,] ... ) 

Returns 1 indicating that the selected variables have 
been read from the fully qualified file jiame. Include can 
be T or 'E', to include or exclude respectively, the 
variables named in varl - vam. 

If include is T and no variables are named, all variables 
are read from filejiame. 

VARWRITE( file_name[, [include] [, varl],] ... ) 

Returns 1 indicating that the selected variables have 
been written to the fully qualified filejiame. Include can 
be T or 'E', to include or exclude respectively, the 
variables named in varl - vam. 

If include is T and no variables are named, 4 all variables 
are written to filejiame. If filejiame exists, it should 
have been created by VAR WRITE and will be appended 
to. 
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3.2 RXWINDOW Functions 

RXWINDOW can be registered with: 

call RxFuncAdd 'W_Register\ 'RXWIN30' , 'rxwindow' 
call WJtegister 

It can be removed (unregistered) with: 
call WJ>eregister 

W_ATTR( window, row, col, length, attr ) 

Returns 1 after setting the screen attributes of a portion 
of a line in window (the handle returned by W_OPEN). 

Row and col are the row and column numbers 
respectively within the window where attr display 
attributes are to take effect on subsequent output. The 
default for attr is defined by the call to W_OPEN. 

W_B0RDER( window[, top] [, right] [, bottom] [, left] - 

- [. attr] ) 

Returns 1 after displaying a border for window (the 
handle returned by W_OPEN). 

Each side of the window can be individually defined with 
the value 0 (no lines), 1 (a single line), or 2 (double 
lines') in top, right, bottom, and left. 



Attr is the display attribute to be used for the border, 
with the default being defined by the call to WOPEN. 

W_CLEAR( window[, attr] [, char] - 

- [, row][, col] [, height] [, width] ) 

Returns 1 after clearing window (the handle returned by 
W_OPEN) or a rectangular portion of window. Attr and 
char can be used to fill the cleared area. 

Height and width define the respective sizes of the area 
to be cleared, each with a default of the remaining area 
on the screen. W_CLEAR() is analogous to the 
SCRCLEARQ function (page 92). 
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W_CL0SE( window ) 

Returns 1 after permanently closing window (the handle 
returned by W_OPEN) and removing all related 
information. The screen contents under the window are 
restored to what they were before window was opened. 

W_FIELD( window, fieldjiame, row, col, length - 

- [, attr][, pad] ) 

Returns 1 indicating that a named area, fieldjiame, has 
been defined within window (the handle returned by 
WOPEN) as an input area where data can be keyed; 
otherwise, returns 0 if fieldjiame would not be 
positioned within window. 

Fieldjiame is the name assigned to the field. 

Row and col contain the respective positions in window 
where the field begins, with 1, 1 representing the upper 
left corner of window. Length contains the number of 
character positions occupied by field name and is 
truncated at the end of the specified row in window and 
does not wrap around. 

Attr is the display attribute to be used for the field, with 
the default being defined by the call to W_OPEN. Pad, 
with a default of blank, is the character used to fill the 
area. 

W_GET( window, row, col, length[, string] - 

- [,attr][, pad][, activate] ) 

Returns data keyed into the area in window (the handle 
returned by WOPEN) defined by row and col with a 
size of length without wrap around. 

String defines the initial contents of the area and is 
returned if no data is keyed into the area. 

Attr is the display attribute to be used for the field, with 
the default being defined by the call to W_OPEN. Pad, 
with a default of blank, is the character used to fill the 
area. Pad characters at the end of the entered data, and 
only at the end, are stripped before the data is returned. 

Activate instructs W_GET how the input operation is 
deemed complete. 
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N (Normal) indicates that only the Enter and Esc keys 
result in the input operation completing. The Enter 
key results in the keyed data being returned while 
the Esc key results in a null string being returned. 

F (Function keys) allows the Enter and the Esc keys 
along with other keys, except for the editing keys 
listed below, to result in the input operation 
completing with the keyed data being returned 
(even as a result of the Escape key). 

The name of the key that resulted in the input operation 
completing will be placed in the REXX special variable 
ACTIVATION _KEYNAME and can be any of the 
following: 

ENTER C-F1 ... C-F12 

ESC A-F1 ... A-F12 

F1 ... F12 PGUP, PGDN 

S-F1 ... S-F12 OTHER 

W_HIDE( windowf, option] ) 

Returns 1 and temporarily inhibits the display of further 
data written to window (the handle returned by 
W_OPEN) and removes the window from the screen, 
making whatever was behind the window visible. 

Option can be: 

A All, the default, which causes all data in the window 
to become invisible. 

N New, which results in only new data written to 
window to be invisible. 

W_ISFIELD( window, field_name ) 

Returns 1 if field jiaiiie is defined within window (the 
handle returned by WOPEN); otherwise, returns 0. 

W_ISWINDOW( window ) 

Returns if window (the handle returned by WOPEN) 
represents a valid, currently open window; otherwise, 
returns 0. 
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WJ(EYS( window[, tab_option] [, enter-option] - 

- [, keyboard-option] ) 

Returns 1 and controls various aspects of cursor and 
keyboard operations with WGET and WREAD 
functions for window (the handle returned by 
W_OPEN). 

Tab_option can be: 

J Jump, which causes the cursor to automatically 
jump from one field to the next when WREAD is 
used with multiple fields. 

N No jump, the default, which does not allow the 
cursor to automatically jump to the next field. 

Enter_option affects the action resulting from pressing 
the Enter key and can be: 

A Any field, the default, causes the Enter key to act as 
an activation key when the cursor is in any field. 

L Last field, causes the Enter key to act as an 
activation key only when it is used in the last field 
of a window (as defined by the order of WFIELD 
calls). When the cursor is in any other, the Enter 
key causes it to jump to the next field. 

Keyboard-option controls the action of keys on an IBM 
Enhanced Keyboard and can be: 

E Enhanced mode which allows Fll, F12 and 
dedicated key pad keys to act as activation keys. 

F Fold mode, the default, causes keyboard scan codes 
to be "folded" thus, with an Enhanced Keyboard, 
analogous keys on the numeric and dedicated key 
pads return the same codes. 
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W_M0VE( window, row, col ) 

Returns 1 if window (the handle returned by WOPEN) 
can be successfully moved such that the new top, left 
position of the window occupies the position defined by 
row and col; otherwise, returns 0 indicating that no move 
took place because the resulting position of window 
would be off of the screen. 

Row and col represent values relative to the entire 
screen. 

If the move is successful, data beneath the window which 
is now uncovered becomes visible. 

W_0PEN( row, col, height, width[, attr] ) 

Returns the "handle" of a new window opened with the 
described characteristics; otherwise, a null string is 
returned if the open is unsuccessful. This handle is then 
used as the first parameter in all of the other 
RXWINDOW functions. Up to 5000 windows can be 
open at one time. 

Row and col specify the position of the top left corner of 
the window on the screen with 1, 1 being the top left 
corner of the screen. 

Height and width represent the number of rows and 
columns respectively the window is to occupy. The limit 
for each of these fields is the size of the screen as 
returned by any of the functions that return screen size 
(SCRSIZEQ - page 94, SysTextScreenSizeQ - page 58, 
etc.). 

Attr, with a default of 7 (white on black), indicates the 
attribute which will be used for all other RXWINDOW 
functions when a new attribute is not explicitly indicated 
for that function. A complete list of the video attributes 
will be found in Appendix C (page 214). 

W_PUT( window, row, col [, string] [, length] - 

- [, attr][, pad] ) 

Returns 1 after displaying string for length characters, 
padded with pad, at row and col within window (the 
handle returned by W_OPEN). If string is omitted, a null 
string is written. 
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WPUT is included primarily for compatibility with £ 
prior version of RXWINDOW. See the REXXLIB User's 
Guide for further details. 

W_READ( window, [fieldjiame] [, activate] ) 

Returns 0 if activate is 'N f and the read is terminated 
with the Esc key; otherwise, returns 0. W_READ reads 
user input from any currently defined input fields ir 
window (the handle returned by W_OPEN). At least one 
such field must be defined. 

If fieldjiame is specified, it designates the field in whicl 
the cursor will initially be positioned. Alphabetic case is 
ignored. If fieldjiame is not specified, the cursor wil 
initially be placed at the beginning of the first input field 
defined for the window. 

Activate instructs W_READ how the input operation is 
deemed complete. 

N (Normal) indicates that only the Enter and Esc keys 
result in the input operation completing. The Entei 
key results in the keyed data being returned while 
the Esc key results in a null string being returned. 

F (Function keys) allows the Enter and the Esc keys 
along with other keys (except for the editing keys 
referenced in connection with W_GET() - page 
100), to result in the input operation completing 
with the keyed data being returned (even as a resull 
of the Escape key). 

In addition to the field variables, the following special 
variables are set: 

• _A CTIVA TIONJCEY contains the code for the ke> 
that ended W READ, if activate is f F (see Appendb 
B- page 211). 

• _A CTIVA TION KEYNAME contains the name, ir 
uppercase, of the key that ended W_READ, i\ 
activate is 'F (see W GET - page 100). 

• _A CTIVA TION FIELD contains the name, in 
uppercase, of the field that the cursor was in when 
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the function terminated, unless activate is 'N' and the 
Esc key was pressed. 

W_SCRPUT( window, row, col, string[, option] ) 

Returns 1 after displaying a string of text, attributes, or 
both in window (the handle returned by W_OPEN). 

Row and col represent positions within window, with the 
top, left corner of the window being 1,1. 

Option can be: 

T Text, the default, indicates that string contains only 
displayable characters. Attributes already present do 
not change. 

A Attributes only. Text already present changes in 
appearance only. 

B Both text characters and attributes are included in 
string as character-attribute pairs with the attribute 
byte following its text character. 

W_SCRPUT is analogous to the SCRPUTQ function 
(page 94). 

W_SCRREAD( window, row, col, lengthf, option] ) 

Reads and returns a string of text, attributes, or both 
from window (the handle returned by WOPEN). Row 
and col, (with the top, left position of the window being 
1,1) indicate the position in the window where reading 
begins. 

Length is the number of screen positions in the window 
to read. If the data to be read extends beyond the end 
of a line, the read will wrap around, for as many lines as 
necessary, up to the end of the screen. 

Option can be: 

T Text, the default, indicates that only text characters 
will be returned. 

A Attributes only will be read. 
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B Both text characters and attributes are included ir 
the returned string as character-attribute pairs with 
the attribute byte following its text character. 

Only data which has been written to the window witl 
RXWINDOW functions is read by WSCRREAD 
W_SCRREAD() is analogous to the SCRREAD(; 
function (page 94). 

W_SCRWRITE( window, row, col [, string] [, length] - 

- [. pad][, attr] ) 

Returns 1 after writing string, with optional attr 
beginning at row and col for length or the length of string 
to window (the handle returned by W_OPEN). 

Row and col represent a position within the window witl 
the top, left corner of the window being 1, 1. 

If length exceeds the length of string, pad is used tc 
complete the write. Appendix C, on page 214, contain* 
a list of the video attributes. 

W_SIZE( window ) 

Returns two words indicating the size of the window ir 
rows and columns. 0 Analogous to SysTextScreenSize^ 
(page 58) and SCRSIZE() (page 94). 

W_UNFIELD( window, field_name ) 

Returns 1 and removes field jmme from window (the 
handle returned by W_OPEN). Field name must have 
previously been defined with W_FIELD. The area of the 
window occupied by fieldjiame will be cleared to blanks 
with the default window attribute. It is not necessary tc 
issue W_UNFIELD() prior to issuing W_CLOSE() tc 
close a window, 

W_UNHIDE( window ) 

Returns 1 after reversing the effect of W_HIDE making 
window (the handle returned from W_OPEN) and al 
further updates to it fully visible. 
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The Workplace Shell information has been collected from 
many different sources. Some of it was provided by, and 
included with the permission of Development Technologies, 
Inc. Their information was collected during the development 
of, and through the use of, their DeskMan/2 product. 



4.1 WPS Objects 



The table below (in alphabetic sequence) contains most, 
though not necessarily all, of the predefined WPS object IDs 
and the functions they belong to. The title field contains the 
data extracted from the actual object. Where the title appears 
on more than one line in the table, the actual title contains a 
single space at the end of each table line. The carat character 
( A ) implies a new line in the title beneath the object's icon. 

The list includes the object IDs created by a complete custom 
installation of OS/2 Warp 4. Please note that object IDs are 
case sensitive. For example, you cannot specify 
<WP_DESKTOP> & <WPJDesktop> interchangeably. 
Many of the object titles were changed in Warp Version 4. 
Where a different title is assigned to the same object ID, both 
are shown. Notations within parenthesis are descriptive only. 



Object ID 



Title 



<16Color_Template> 

<256Co1 or_Templ ate> 

<ADV_ASSIST> 

<ADV_ASSIST_REG> 

<ADV_DIALER> 

<ADV_REG> 

<ADV_REG> 

<A0S2WARP> 

<ASKREADME> 

<AVIJ r ILEJJTILITY> 

<Address A Book> 

<CAGINSTS> 

<CAS0S2> 



Solid Color Palette (V3) 
Mixed Color Palette (V3) 
Customer A Assi stance (V3) 
Registration (V3) 
IBM Internet A Dialer (V3) 
IBM Internet A Customer 
Services (V3) 
IBM Internet A Customer 
Services* (Modem) (V4) 
AskPSP (V4) 
AskPSP A ReadMe (V4) 
AVI File Utility (V4) 
Address A Book (V3) 
SystemView Agent A Remove 
(V4) 

OS/2 agent startup (V4) 
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Title 



<CLTRMOVE> 

<CLTSTART> 

<CLT_REMOTE> 

<CPREADME> 

<Cal 1 A Manager> 

<Chalkboard> 

<Clip> 

<FFST_SETUP> 
<FPGuide> 

<FPW_CATALYST> 
<FPW_HALITE> 
<FTPPM Tempi ate> 
<Getting A Started> 
<IAK> 

<IAK> 

<IAK_3270> 

<IAK_FTP> 

<IAK_FTP> 

<IAK_GOPHER> 

<IAKJ50PHER> 

<IAK_HELP> 

<IAKJIR2> 

<IAK_NR2> 

<IAK_README> 

<IAK_RSU> 

<IAK_SLIPPM> 

<IAK_TELNET> 

<IAK_TELNET> 

<IAK_TEMPLATES> 

<IAK_TEMPLATES_3270> 

< I AK_T EM P LAT ES_FT P PM> 

<IAK_TEMPLATES_FTPPM> 

<IAK_TEMPLATESJELP> 

< I AK_T EM P LAT ES_T E LN ET> 
<IAK TEMPLATES TELNET> 



Remove Instal lation*for 
Networking (V4) 
Selective Install A for 
Networking (V4) 
OS/2 Warp A Remote Install 
(V4) 

CasePoint A Release Notes 
(V4) 

Call A Manager (V3) 
Chalkboard (V3) 
Clip (V3) 
FFST Setup (V4) 
File and Print 
Client A Guide (V4) 
Footprint Catalyst (V3) 
HyperACCESS A Lite (V3) 
FTP-PM (V4) 
Getting A Started (V3) 
IBM Internet A Connection 
for OS/2 (V3) 
Internet* (Modem) (V4) 
3270 Telnet (V3) 
FTP-PM (V3) 
FTP- PM A (Modem) (V4) 
Gopher (V3) 
Gopher A (Modem) (V4) 
Introduction to the* IBM 
Internet Connection (V3) 
NewsReader/2 (V3) 
NewsReader/2 A (Modem) (V4) 
READ ME FIRST (V3) 
Software Updates (V4) 
Dial Other A Internet 
Providers (V3) 
Telnet (V3) 
Telnet* (Modem) (V4) 
Appl i cati on *Templ ates(V3) 
3270 Telnet (V3) 
FTP-PM (V3) 
FTP-PM*Modem (V4) 
How do I*use Templates? 

(V3) 

Telnet (V3) 
Telnet*Modem (V4) 
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Title 



<IAK_UPDATE> 

<IAK_UTiLITIES> 
<IAK_UTILITIES> 

<IAK__WEB> 

<IAK_WEB_SHAD> 

<InfoHighway> 



Retrieve'Software 
Updates (V3) 
Internet'Utilities (V3) 
Internet 

Utilities* (Modem) (V4) 
WebExpl orer A (Modem) (V4) 
WebExplorer* (Modem) (V4) 
IBM 

Information A Superhighway 
(V3) 

copyrght (V4) 
Editor for Java (V4) 



<JAVA_Copyright> 
<JAVA_Edi torf orJava> 
<JAVA_JavaAppl etVi ewerFromHTML> 

Java Applet Viewer from 
HTML (V4) 
<JAVA_JavaAppletViewerFromURL> 

Java Applet Viewer from 
URL (V4) 
Compile Java code (V4) 
Disassemble Java class 
file (V4) 
Display methods in Java 
class file (V4) 
Generate documentation 
from Java code (V4) 
<JAVA JavaWindow>0S/2 Window for Java(V4) 



<JAVA_JavaCompiler> 
<JAVA_JavaDi sassembl e> 

<JAVA_JavaDi spMethod> 

<JAVA JavaGenDoc> 



<JAVA_0S2> 
<JAVA 0S2 SMPLS> 



<JAVA_0S2_SMPLS_URLS> 
<JAVA 0S2 TLKT> 



< J A V A_Ru n J a v a PM P rog ram> 

<JAVA_RunJavaProgram> 

<JAVA_SHDW_demo> 

<JAVA_SHDW_weblogs> 

<KARATCA> 

<LDCS REM0VE> 



Java for OS/2 (V4) 
Samples for Sun's Java 
Programming 

Environment (V4) 
URLs for Samples (V4) 
Toolkit for Sun's Java 
Programming Environment 
(V4) 

Run Java PM Program (V4) 
Run Java Program (V4) 
demo (V4) 
weblogs (V4) 
SystemView Agent* System 
Management Agent (V4) 
Remote Access 
Client A Remove (V4) 
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Title 



<LD ADV GUIDE> 



< L D_C L I ENT_GU I D E> 

<LSGuide> 

<LS ADMIN> 



<LS ADMIN SHADOW> 



<LS_AUDIT> 
<LS_CLIP> 

<LS_ERROR> 
<LS_FOLDER> 
<LS_FOLDER_SHADOW> 
<LS INSTALL> 



<LS_NETMSG> 
<LS_START> 

<LT_SAMPLE> 

<MAH_EXE> 

<MAH_FOLDER> 

<MAH_Folder> 

<MARSCM1> 

<MCIREXXJNF> 
<MCMDOC> 

<MCMPROG> 



<MCMSPY> 
<MCMSTOP> 



<MFSCP> 

<MFSREADME> 

<MFSS> 



Remote Access Advanced 
Guide* LAN Distance 
Advanced Guide (V4) 
Remote Access 
Client A Guide (V4) 
LAN Admini strati on A Guide 
(V4) 

LAN 

Server A Admi ni strati on 

(V4) 

LAN 

Server A Admi ni strati on 

(V4) 



Audit Log (V4) 
Network DDE A and 
Clipboard (V4) 
Error Log (V4) 
Logons (V4) 
Logons (V4) 
File and Print 
ClientMnstall/Remove 

(V4) 

Network Messaging (V4) 
Start A File and Print 
Client (V4) 
Multimedia Viewer (V3) 
Mahjongg (V3) 
Mahjongg Solitaire (V3) 



Mahjongg Folder (pre V3) 
Mobile Office Services 

(V4) 

Multimedia With REXX 
Mobile Office 
Services A Guide (V4) 
Start A Mobile File 
Sync A Mobile Office 
Services (V4) 
Spy Utility (V4) 
Stop A Mobile File 
Sync A Mobile Office 
Services (V4) 
Clear Persistence (V4) 
MFS README (V4) 
MFS Setup (V4) 
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<MFSST> 

<MMPM_CDPLAYER1> 

<MM PM_DA P L AY ER 1 > 

<MMPM_MIDIPLAYER1> 

<MM PM_V I D PLAY ER1 > 

<MMPM2_AUDIOFINDER> 

<MM PM2_AV I_F I LE_UT I L I T Y> 

<MMPM2_BITMAP> 

<MMPM2_FOLDER> 

<MMPM2J r older> 

<MMPM2_IMAGEFINDER> 

<MMPM2_IMAGES> 

<MMPM2_MASTERVOLUME> 

<MMPM2_MASTERVOLUME_D> 

<MMPM2_MIDIFINDER> 
<MMPM2_MINSTALL> 

<MM PM2_M I N STA L L> 

<MMPM2__MMCDDEVICE01> 
<MMPM2_MMCDDEVICETEMPLATE> 
<MMPM2 MMCONVERTER> 



Stashing Database (V4) 
Compact Disc (V3) 
Digital Audio (V3) 
MIDI (V3) 
Videodisc (V3) 
Digital audio (V4) 
AVI File Utility (V3) 
Bitmaps (V4) 
Multimedia (V4) 
Multimedia (Folder) (V3) 
Image (V4) 
Images (V4) 
Volume Control (Desktop) 
Volume Control (MMPM2 
Folder) 

MIDI (V4) 
Multimedia Install 

(pre V3) 
Mul timedia A Appl ication 
Install (V4) 
Compact Disc (V4) 
Compact Disc (V4) 
Multimedia Data 
Converter 
Lighttable 



(V4) 
(V4) 



<MMPM2_MMFOLDERTEMPLATE> 
<MMPM2_MMLVDDEVICETEMPLATE> Videodisc 
<MMPM2_MMTEMPLATEF0LDER> Multimedia Templates (V4) 
<MMPM2_MMV0LUME> Volume (V4) 

<MMPM2_M0VIES> Movies 
<MMPM2_README> README 
<MMPM2_SETUP> Multimedia Setup 

<MMPM2_SNDSHAD> Sound (Sound Shadow) 

<MMPM2_S0FTWARE_M0TI0N_VIDE01> Digital Video 
<MMPM2_SOFTWARE_V I DEO_RECORDER> Video IN'Recorder 

(V3) 



<MMPM2_S0UNDS> 

<MMPM2_VIDE0FINDER> 

<MPTSCfg> 



<MPTS_DDNS_OBJECT_SETUP> 
<NFCLIENTGUIDE> 



Sound Bites 

Digital video (V4) 
Network Adapters 
and A Protocol Services 
Guide (V4) 
DDNS Configuration (V4) 
System Managements ient 
Guide (V4) 
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<NFNETDRV> 
<NFNETIPC> 
<NFREADME> 

<NFREADME_SHAD> 

<NFSVCMGR> 
<NP_DHCP_GUIDE> 

<NP_DIPJNTRO> 

<NSC_FOLDER> 

<NSC_PM> 

<NSC_REF> 

<NSC_REMOVE> 

<NSC_RETRY> 

<NSC_SVR> 
<NTS_MPTS_ICON> 

<ODOC_FOLDER> 

<ODJNTRO> 

<OD_PREFS> 

<OD_SCRPER> 

<0D_SHELLPLUGINS> 

<OD_TEMPS> 

<P2P/2> 

<PCOMADM> 



Network Driver 
Configuration (V4) 
TME 10 NetFinity Network 
Interface (V4) 
TME 10 NetFinity A System 
Management Client A Read 
Me (V4) 
TME 10 NetFinity A System 
Management Client A Read 
Me (V4) 
TME 10 NetFinity Service 
Manager(V4) 
TCP/IP DHCP 
CI ient Administration 
Guide (V4) 
TCP/IP Dynamic 
^Introduction (V4) 
Password A Coordi nation 

(V4) 

Password A Coordi nation 

(V4) 

Password 

Coordination A Guide (V4) 
Password 

Coordination A Remove (V4) 
Password 

Coordination A Retry 
Process (V4) 
Password 

Coordination A Server (V4) 
MPTS A Network 
Adapters A and Protocol 
Services (V4) 
OpenDoc for OS/2 (V4) 
OpenDoc Guide (V4) 
Part Editor Preferences 
(V4) 

Script Editor A and 
Recorder (V4) 
OpenDoc Shell Plug-ins 

(V4) 

OpenDoc Templates (V4) 
P2P/2 (V3) 
Administration Tools (V4) 
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<PCOMOS2> 



<PDP_FOLDER> 

<PDP_PMDF> 

<PDP__PMDFDOC> 

<PDP_SMARTPFA> 

<PDP_SYSLOG> 

<PDP_TRACE_DOC> 

<PDP_TRACE_FMT> 

<PDP__TRACE_FOLDER> 

<PDP_TRACE_OFF> 

<PDP_TRACE_OFFCLEAR> 

<PDP_TRACE_ON> 
<PDP_TRACE_ONCLEAR> 

<PDPJTRACE_ONRESUME> 
<PDP_TRACE_ONSUSPEND> 
<PEER_LANLOGON> 
<PEER_LOCALLOGON> 



<PEER_LOGOFF> 
<PEER_USER> 
<PEER WKST> 



<PMDM2IMAGE> 
<Pupil731B> 

<Pupil731B_Disk> 



<Pupil731B_Guide> 

<Pupil731B_Info> 

<README_MM> 

<RPSM_FLD> 

<SAMPLE_SOURCE> 



Personal 

Communications A 3270/5250 



Emulation (V4) 
Problem Determination 
Tools (V4) 
PM Dump Facility (V4) 
PMDF Doc (V4) 
Hard File Monitor (V4) 
System Error Log (V4) 
Trace Doc (V4) 
Trace Formatter (V4) 
Trace Options (V4) 
Trace OFF (V4) 
Trace OFF Clear Buffer 

(V4) 

Trace ON (V4) 
Trace ON Clear Buffer 

(V4) 

Resume Trace (V4) 
Suspend Trace (V4) 
LAN Server* Logon (V4) 
File and Print 
Client A Workstation Logon 
(V4) 

Logoff (V4) 



Network User Account (V4) 
Shared Resources 
and A Network Connections 
(V4) 

PM Image 

Remote Support'for OS/2 
(V4) 

Remote Support* for 
0S/2 A Create Client 
diskette in A: (V4) 
Remote Support for 
0S/2 A User Guide (V4) 
Remote Support for 
0S/2 A User Guide (V4) 
Double-Click Here 
(Multimedia Readme) (V3) 
TME 10 NetFinity 'System 
Management Client (V4) 
Source (V4) 
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<SNMPCNFIG> 


OS/2 Agent Configuration 




(V4) 


<SNMPTRAP> 


SNMPTRAP (V4) 


<SPCH_CHKINST> 


S\ 1 i x alia* / t t m \ 

Check Installation (V4) 


<SPCH_DICTATION> 


Dictation Window (V4) 


<SPCH_ENROLL> 


Enrollment (V4) 


<SPCH_GAMES> 


States Game (V4) 


<SPCH_INSTALLILM> 


Optional Vocabularies 




Instal 1 /Uni nstal 1 (V4) 


<SPCH_MACROEDIT> 


Dictation Macro Editor 




(V4) 


<SPCH_MIGRATE> 


Migrate User Information 




(V4) 


<SPCH_USER> 


Speech User (V4) 


<SPCH_USERGUIDE> 


\i * ~r~ ii l /*» * i 

VoiceType User's Guide 




(V4) 


<SPCH_WW> 


Voice Manager (V4) 


<SVAUSR> 


System Management A Agent 




Guide (V4) 


<SVA_README> 


IBM SystemView Agent 




Readme (V4) 


<SVA_README_SHAD> 


IBM SystemView Agent 




Readme (V4) 


<SampleApp> 


CompuServe (V3) 


<SampleApp 


EXE> CIM for OS/2 (V3) 


<SampleApp 


ReadMe> Read Me (V3) 


<Samp1eApp 


Signup> Member Signup(V3) 


<Scheme_Pal ette_96_Templ ate> 




Scheme Palette (V4) 


<Stills A Capture> 


Stills A Capture (V3) 


<TCP/IP15> 


TFTP (V4) 


<TCP/IP15_SHAD> 


TFTP (V4) 


<TCP/IP17> 


TCP/IP A Command Reference 




(V4) 


<TCP/IP18> 


TCP/IP A Guide (V4) 


<TCP/IP1> 


FTP (V4) 


<TCP/IP1 SHAD> 


FTP (V4) 


<TCP/IP50> 


TCP/IP Startup (V4) 


<TCP/IP5> 


PM Ping (V4) 


<TCP/IP5 SHAD> 


PM Ping (V4) 


<TCP/IP8> 


TCP/IP A Configuration - 




A (LAN) (V4) 


<TCP/IP8_SHAD> 


TCP/IP A Configuration - 




A (LAN) (V4) 
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<TCP/IP> 

<TCP/IPDB1> 

<TCP/IPDB1M> 

<TCP/IPDB2> 

<TCP/IPDB2M> 

<TCP/IP_GOPHER> 

<TCP/IP_NR> 

<TCP/IP_README_DBX1> 

<TCP/SETTERM> 
<TCP/SETTERM_SHAD> 
<TCPFTP> 
<TCPFTPRX> 

<TCPIP_WEB> 

<TCPIPJJEB_SHAD> 

<TCPSORX> 

<TCPTELNET> 

<TCP_FTP> 

<TC P R E A DM E_ I N F> 

<TCP_TELNET> 

<TCP_UINSTALL> 

<TCPJJTIL_FOLDER> 

<TCPJJTIL_FOLDER_SHAD> 

<TK_CSAMPLE> 
<TK_DEVINFO> 

<TK_DEVTOOLS> 

<TK_TOOLKIT> 

<Talk> 

<ULTIMAIL_ADDRBOOK> 
<U LT I MA I L_CAB I N ET> 
<ULTIMAIL_INBASKET> 
<ULTIMAIL_INFO_LITE> 
<ULTIMAIL_LITE> 

<U LT I MA I L_N EW LETTR> 
<ULTIMAIL SHADOW> 



TCP/IP A Internet A (LAN) 



(V4J 

Windows-Ping (V4) 
Windows-Ping (V4) 
DOS Ping (V4) 
DOS Ping (V4) 
Gopher* (LAN) (V4) 



NewsReader/2 A (LAN) (V4) 
TCP/IP for 

A DOS/Windows A Read Me (V4) 
Telnet A Customization (V4) 
Telnet A Customization (V4) 



FTP-PM A LAN (V4) 
TCP/IP REXX FTP - 

API Reference (V4) 

WebExplorer A (LAN) (V4) 

WebExplorer A (LAN) (V4) 
TCP/IP REXX Sockets 

API "Reference (V4) 

Tel net A LAN (V4) 

FTP-PM* (LAN) (V4) 

TCP/IP A Readme (V4) 

Tel netPM A (LAN) (V4) 



TCP/IP Services A Remove 

(V4) 

TCP/IP Utilities A (LAN) 

(V4) 

TCP/IP Utilities* (LAN) 

(V4) 

Sample Programs Folder 
Toolkit Information 
Folder 

Development Tools Folder 
Toolkit 2.1 Folder 
Talk (V3) 
Names and A Addresses 
Mail Cabinet 
In-basket 

Information (V3) 
Ultimedia A Mail/2 'Lite' 
(V3J 

New Letter 

Ultimedia A Mail/2 'Lite' 
(V4) 
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<UMA1L VltW rf\\) Lllt> 


111 f iMsi 1 

u I ti Mai i 







1 Li te 1 A Frequently 






asked A Questions 


(V4) 


^IIMAYI \/TCU DCAHMT 1 TTC*> 

<UMA1L View KtAUMt Lllt> 


Keaa rie 




<UMAI L_V I EW_README_L I TE> 


U I tiMai 1 Li te A Read 






Me 


(V4) 


<UMAIL_VIEW_TUTORIAL_LITE> 


Tutorial 


(V3) 


<"IIMA7I \/TPU IKP 1 TTC^ 


User's Guide 


(V3) 


<UMA I L_V I EW_U5G_L I T E> 


Ul tiMai 1 'Lite' 'Guide 






(V4) 


<UPM ACCTS> 


User Account - 






Management 


(V4) 


<UPM rULUtK> 


UPM Services 


(V4) 


<UPM_LOGOFF> 


Logoff 


(V4) 


i r>M i nmMs 
<UrM LUbUN> 


Logon 


(V4) 


<L)KLr BUb> 


Business & Shopping 


(V4) 


<UKLr LUMr> 


Computing 


(V4) 


<L)RLF EDU> 


Education 


(V4) 


-lint r~ CMTo^ 

<URLF_ENT> 


Entertainment 


(V4) 


<URLF_IBM> 


IBM Web Pages 


(V4) 


<UKLr NtWo> 


News and Sports 


(V4) 


<URLF 0S2> 


OS/2 Related Web Pages 






(V4) 


<URLF_REF> 


Reference 


(V4) 


<URLF_SEARCH> 


Web Search Sites 


(V4) 


jilt r\rATii TftirA*. 

<VIDE0IN_INF0> 


Video In Users Guide 


(V4) 


ji / t r\rAT m np Anur«. 

<VIDEOIN_README> 


README. VIN 


(V3) 


<VlUtUlN KtAUI v lt > 


VideoIN* Readme 


(V4) 


<VIUtU KtLUKUtK> 


VideoIN'Recorder 


(V4) 


<vi aeo> 


Video 


(V3) 


<WL N h 1 b t KV> 


Network Services 


(V4) 


<WL WtbtA rULU> 


WebExplorer 


(V4) 


<WrlMhl Hub 11 tMrLAI t> 


FTP HOST 


(V4) 


^LinTMCT TCMDI ATCCs 

<WPINt l_l LMPLAI hb> 


Templates for A Internet 






(V4) 


<WPINLI UKLrULUtK 1 tnPLAl t> 


URL Folder 


(V4) 


<WP APPLbK> 


Appl ication 






Considerations 


(V3) 


<WP ArrbrULLJLK> 


Appl i cations 


(V4) 


<WP ART> 


Software Registration 






(V4) 


<WP Abblb 1 ANLt> 


Assistance Center 


(V4) 


<WP_B00T> 


Create Utility Diskettes 






(V3) 
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<WP_CHART> 

<WP_CHESS> 

<WP_CLIPV> 

<WP_CLOCK> 

<WP_CLRPAL> 

<WP_CMDREF> 

<WP_CNTRY> 
<WP_CONFIG> 

<WP_CONNECTIONSFOLDER> 

<WP_COOLURLSFOLDER> 

<WP_DALARM> 

<WP_DBASE> 

<WP_DBOOT> 

<WP_DCALC> 

<WP_DCALEM> 

<WP_DDARC> 

<WP_DDIARY> 

<WP_DDINST> 

<WP_DESKTOP> 

<WP_DLIST> 

<WP_DMNTH> 

<WP_DNOTE> 

<WP_DOSFS> 

<WP_DOSWIN> 

<WP_DOSJ)RV_A> 

<WP_DOS_DRV_A> 

<WP_DRIVES> 

<WPJ)RIVESSHADOW> 

<WP_DTARC> 

<WP_EPM> 

<WP_FNTPAL> 

<WP_FPWO_CHTEMP> 

<WP_FPWO_DBTEMP> 

<WP_FPWO_EXE> 

<WP_FPWO_FOLD> 

<WP_FPWO_GRTEMP> 

<WP_FPWO_README> 
<WP_FPWO_RWTEMP> 
<WP_FPWO_SAMP_FOLD> 
<WP_FPWO_SSTEMP> 
<WP FPWO WPTEMP> 



PM Chart (pre V3) 

OS/2 Chess 
Clipboard Viewer 
System Clock 

Color Palette (pre V3) 
OS/2 Warp Command 
Reference (V4) 
Country 
System Setup 

Connections (V4) 
Web Sites (V4) 
Alarms (pre V3) 

Database (pre V3) 

Dual Boot (pre V3) 

Calculator (pre V3) 

Calendar (pre V3) 

Planner Archive (pre V3) 
Daily Planner (pre V3) 
Device Driver Install 
Desktop 

Activities List (pre V3) 

Monthly Planner (pre V3) 

Notepad (pre V3) 

DOS Full Screen 

DOS Window 

DOS From Drive A: 

DOS from Drive A: (V4) 

Drives 

Drives (V4) 
To-Do List Archive 

(pre V3) 

Enhanced Editor 
Font Palette 

Chart (V3) 
Database (V3) 
IBM Works (V3) 
IBM Works (folder) (V3) 
Contact List (template) 
(V3) 

ReadMe (V3) 
Report (template) (V3) 
TEMPLATE (V3) 
Sheet (template) (V3) 
Document (template) (V3) 
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<WP__FPWPIMA_EXE> 


Appointments 


(V3) 


<WP_FPWPIME_EXE> 


Event Monitor 


(V3) 


<WP_FPWPIMG_EXE> 


Planner 


(V3) 


<WP_FPWPIMN_EXE> 


Notepad 


(V3) 


<WP_FPWPIMP_EXE> 


Phone/Address Book 


(V3) 


<WP_FPWPIMS_EXE> 


PIM Preferences 


(V3) 


<WP_FPWPIMT_EXE> 


To Do List 


(V3) 


<WP_FPWPIMY__EXE> 


Year Calendar 


(V3) 


<WP_GAMES> 


Games (folder) 




<WP_GLOSS> 


Glossary 




<WP_HIRESCLRPAL> 


Mixed Color Palette 


(V3) 


<WP_HWMGR> 


Hardware Manager 


(V4) 


<WP 1 ICON> 


Icon Editor 




<WPJGSCHECKIN> 


User Check- In A for 






WarpGuide 


(V4) 


<WP_IGSFOLDER> 


WarpGuide 


(V4) 


<WP_INFO> 


Information 




<WP_INFOOVERFOLDER> 


Online Information 






Overview 


(V4) 


<WP_INST> 


Selective Install 




<WP_INSTALLED> 


Installed Features 


(V4) 


<WP_INSTREMFOLDER> 


Instal 1 /Remove 


(V4) 


<WP_JIGSAW> 


Jigsaw (pre V3) 


<WP_KEYB> 


Keyboard 




<WP_KLDK> 


Klondike Solitaire 


(V4) 


<WP_KLDK> 


Solitaire - Klondike 




<WP_LAUNCHPAD> 


LaunchPad 


(V3) 


<WP_LORESCLRPAL> 


Solid Color Palette 


(V3) 


<WP_MIGAPP> 


Add Programs 


(V4) 


<WP_MIGAPP> 


Migrate Applications 




<WP_MINDEX> 


Help Index 


<V4) 


<WP_MINDEX> 


Master Help Index 




<WP_MOUSE> 


Mouse (Settings) 




<WP_MULTIMBK> 


Mul timedia 


(V3) 


<WP_NEKO> 


Cat and Mouse (pre V3) 


<WP_NETWORK> 


Network (folder) 




<WP_NEWFOLDER> 


New Folder 


(V4) 


<WP_NEWPROGRAM> 


New Program 


(V4) 


<WP_NEWREMOTEPRINTER> 


Network Printer 


(V4) 


<WP_NOWHEREl> 


Nowhere (Hidden folder) 






(V3) 


<WP NOWHERE> 


Nowhere (Hidden folder) 


<WP_ONLINE> 


Using Online - 






Information 


(V4) 
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<WP_OS2FS> 

<WP_0S2SYS> 

<WPJ)S2UGBK> 

<WP_OS2WIN> 
<WP_OVERVIEW> 

<WPJ>DVIEW> 
<WP_PERFBK> 

<WPJ>ICV> 
<WP_POWER> 

<WP_PRINTBK> 

<WP_PRINTERSFOLDER> 

<WPJ>ROGRAMSFOLDER> 

<WP_PROMPTS> 

<WP_PTR_AQUA> 

<WP_PTR_BIG_BLAC> 

<WPJ>TR_BIG_WHIT> 

<WP_PTR_BLACK> 

<WP_PTR_BLUE> 

<WP_PTR_GLOVES> 

<WP_PTR_GOLD> 

<WP_PTR_GRAY> 

<WP_PTR_GREEN> 

<WP_PTR_LH_BIG_B> 

<WP_PTR_LH_BIG_W> 

<WP_PTR_LH_BLACK> 

<WP_PTR_LH_GLOVE> 

<WP_PTR_LH_WHITE> 

<WP_PTR_PINK> 

<WP_PTR_RED> 

<WP_PTR_WHITE> 

<WP_PULSE> 

<WP_RDME> 

<WP_RDME> 

<WP_READMEFOLDER> 

<WP REFCMDFOLDER> 



OS/2 Full Screen 




OS/2 System 




OS/2 Warp Desktop 


-♦ 


Guide 


(V4) 


OS/2 Window 




OS/2 Warp System 




Overview 


(V4) 


Printer (pre V3) 


Performance 




Considerations 


(V3) 


Picture Viewer 




(Power Mgmt. - no 


title 


specified) (pre V3) 


Printing in OS/2 


(V3) 


Printers 


(V4) 


Programs 


(V4) 


Command Prompts 




Aqua 3D Pointers 


(V4) 


Big Black Pointers 


(V4) 


Big White Pointers 


(V4) 


Small Black Pointers (V4) 


Blue 3D Pointers 


(V4) 


Glove Pointers 


(V4) 


Gold 3D Pointers 


(V4) 


Gray 3D Pointers 


(V4) 


Green 3D Pointers 


(V4) 


Big Left-Handed Black 


Pointers 


(V4) 


Big Left-Handed White 


Pointers 


(V4) 


Small Left-Handed 


Black 


Pointers 


(V4) 


Left-Handed Glove 




pointers 


(V4) 


Small Left-Handed 


White 


Pointers 


(V4) 


Pirik 3D Pointers 


(V4) 


Red 3D Pointers 


(V4) 


Small White Pointers (V4) 


Pulse 




README 


(V4) 


ReadMe 




Read Me 


(V4) 


Reference and Commands 
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(V4) 


<WP_REXREF> 


REXX Information 




<WP_RJAPPLETPROGREF> 


RJAPPLET 


(V4) 


<WP_RS231B> 


Remote Support A for OS/2 






(V4) 


.1 m nunc t 

<WP_RVRSI> 


Reversi 


(pre V3) 


<WP_SCHPAL28> 


Scheme Palette 


(V3) 


<Wr btnrALyD> 


Scheme Palette 


(V4) 


<WP SCHPAL> 


Scheme Palette 


(pre V3) 


<Wr bLKDL> 


Scramble 


(pre V3) 


<WP_SEEK> 


Seek and Scan Files 


<Wr bHKtLJ> 


Shredder 




<WP S0UND> 


Sound 




| <WP SPEECH> 


VoiceType 


(V4) 


<WP SP00L> 


Spooler 




<Wr brKtAU> 


Spreadsheet 


(pre V3) 


<WP START> 


Startup 




^.i i n rn i n«^ 

<WP_STHR> 


Start Here 


(pre V3) 


<WP_STICKY> 


Sticky Pad 


(pre V3) 


<WP_SYSED> 


OS/2 System Editor 


<WP SYSTEM> 


System 




j <WP_TASKSINFO> 


Tasks 


(V4) 


<WP TEMPS> 


Templates 




<WP TERM> 


PM Terminal 


(pre V3) 


<WP T0D0> 


To-Do List 


(pre V3) 


<Wr IUOLb> 


Productivity 




! ^i.i n tooi c«s. 
j <Wr lUULb> 


Util i ties 


(V4) 


<WH IUULH> 


Touch 




<Wr ! KAUtl y iDK> 


Trademarks 


(V3) 


^-lin TDD 1 CUTs 


Troubleshooting 


(V4) 


<WP 1 RUUDLtlNr-U> 


Troubleshooting 


(V4) 


<WP_TUNE> 


Tune Editor 


(pre V3) 


S <WP TUT0R> 


OS/2 Warp Tutorial (V4) 


<WP UNINST> 


Selective Uninstall (V3) 


<WP_VIEWER> 


Mini mi zed* Window 


Viewer 


<WP_VIEWINF> 


View 


(V4) 


<WP_WALX> 


IBM LAN Distance 


(V4) 


in MAI V CUARs 

<Wr WALa bHAU> 


IBM LAN Distance 


(V4) 


<Wr WAKrLtN 1 tK> 


WarpCenter 


(V4) 


-im l 1 T MO! ITIiK 

<WP WIN2WIN> 


WIN-OS/2 Window 


(V3) 


<WP_WINCFG> 


(none - MIN-OS/2 Setup) 






(pre V3) 


<WP WINCFG> 


WIN-OS/2 Setup 


(V3) 


<WP WINFS> 


WIN-OS/2 Full Screen 
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Object ID 



Title 



<WP_WINOS2BK> 


Windows Programs in OS/2 






(V3) 


<WP_addProg> 


Guidance on A Adding 






Program Objects 


(V4) 


<WP_chkIn> 


Guidance on A WarpGuide 




Check-In 


(V4) 


<WP_findObj> 


Guidance on A Finding 






Things 


(V4) 


<WP_selInst> 


Guidance on* System 






Instal lation 


(V4) 


<WP_sysPrt> 


Guidance on A Adding a 






Printer 


(V4) 


<WP_sysWiz> 


Guidance on A System 






Customization 


(V4) 


<WP_wgSettg> 


Guidance on A The 






WarpGuide 


(V4) 


<WSWIN> 


Workspace Manager 


(V4) 


<WS_DHCP_MONITOR> 


DHCP Monitor 


(V4) 






(V3) 



Note: The object IDs created for printers 
(< WPPO... > ) will vary depending on the printer 
queue driver installed. 

See the Syslni() function in the OS/2 REXX Information on- 
line help facility for an example of how to list all of the 
program objects in your system. 



4.2 WPS Classes - Prior to Warp 3 

The following hierarchical list contains most, though not 
necessarily all, of the predefined WPS class names and the 
name of the DLL module (Dynamic Link Libraiy) which 
contains the class method, where known. WPS class names do 
not appear to be case sensitive. 

Class Name DLL name 

WPObject PMWP 

- WPAbstract PMWP 

— Dman DESKMAN 

— WPClock WPCONFIG 

— WPCountry WPCONFIG 

— WPDisk PMWP 
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Class Name 



DLL name 



WPKeyboard WPCONFIG 

WPMouse WPCONFIG 

WPPalette WPCONFIG 

— WPColorPalette WPCONFIG 

— WPFontPalette PMWP 
1 — WPSchemePalette WPCONFIG 

WPPower WPCONFIG 

WPPrinter WPPRINT 

1 — WPRPrinter WPPRINT 

— WPProgram PMWP 
WPShadow PMWP 

WPSharedDir PMWP 

WPShredder PMWP 

WPSound WPCONFIG 
WPSpecial Needs 

WPSpool WPPRINT 

WPSystem WPCONFIG 

WPTouch TCP 

WPWinConfig WINCFG 

WPFileSystem PMWP 

— WPDataFile PMWP 

- WPBitmap PMWP 

- WPIcon PMWP 

- WPMet PMWP 

- WPPif PMWP 

- WPPointer PMWP 

- WPProgramFile PMWP 
1 — WPCommandFile PMWP 

1 — WPFolder PMWP 

- ExtendedDeskTop EXTDESK 
— WPDesktop PMWP 

- WPDrives PMWP 

- WPFindFolder PMWP 

- WPMinWinViewer PMWP 

- WPNetgrp PMWP 

- WPNetwork PMWP 

- WPRootFolder PMWP 

- WPServer PMWP 

- WPStartup PMWP 
1 — WPTemplates PMWP 

WPTransient PMWP 

PDView WPSPL 

WPDiskCV PMWP 

WPFilter PMWP 

WPFolderCV PMWP 
WPJob 

WPMinWindow PMWP 
WPPort 

WPPrinterDriver PMWP 
WPQdr 



The following list contains other WPS classes that have been 
identified but whose position in the above structure is 
unknown. 
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Mi ndex 




MMbouna 


mm ^ wn 


rUVl ew 


U P <\ P 1 


WPA mnem 


UPMI ^ 
Wrli Lo 


U DPn y->\/ J qui 


PMWP 


LID T mc* 
Wr Illlc 




WPFHr 
n r r U l 


WPNLS 


WPFinder 


PMWP 


WPNetLink 


PMWP 



4.3 WPS Classes - Warp Version 3 

The following figure lists the predefined Workplace object 
classes in a hierarchical order. Each branch in the tree 
represents an immediate descendant (subclass) of a Workplace 
object class. The predefined SOM object class, SOMObject, is 
the root class for all SOM object classes, including all 
Workplace object classes. The class definition files (IDL) can 
be found in the Warp toolkit in 
..\WARPTLKT\TOOLKIT\IDL. 

Class Name Class Definition Files 



WPObject wpobject. id! 

— WPAbstract wpabs.idl 

Dman DESKMAN.DLL 

WPClock wpclock. 

WPCountry wpctry. 

WPDisk wpdisk. 

WPLaunchPad wplnchpd. 

WPKeyboard wpkeybd. 

WPMouse wpmouse. 

WPPalette wppalet. 

WPCol orPal ette wpcl rpal . 

WPFontPalette wpfntpal . 

1 — WPSchemePalette wpscheme. 

WPPower wppower. 

WPPrinter wpprint. 

WPProgram wppgm. 

WPShadow wpshadow. 

1 — WPNetLink wpnetlnk. 

WPShredder wpshred. 

WPSound wpsound. 

WPSpecial Needs wpspneed. 

— WPSpool wpspool . 

— WPSystem wpsystem. 
WPFi leSystem wpfsys. 

WPDataFile wpdataf. 

— WPBitmap wpbitmap. 

— WPIcon wpicon. 

- WPMet wpmet. 

- WPPif wppif. 

- WPPointer wpptr. 



©1993-1997 by C F S Nevada, Inc. 



123 



Rev 4.0 



Class Name 



Class Definition Files 



WPProgramFi le wppgmf.idl 
1 — WPCommandFile wpcmdf.idl 

WPFolder wpfolder.idl 

- ExtendedDeskTop EXTDESK.DLL 

- WPDesktop wpdesk.idl 

- WPDrives wpdrives.idl 

- WPMinWin Viewer wpmwv.idl 

- WPNetgrp wpnetgrp.idl 

- WPNetwork wpnetwrk.idl 

- WPRootFolder wprootf.idl 

- WPServer wpserver.idl 

- WPSharedDir wpshdir.idl 
— WPStartup wpstart.idl 

- WPTemplates wp temps. idl 
WPWinConfig wincfg.idl 

WPTransient wptrans.idl 

WPJob wpjob.idl 

WPPort wpport.idl 

WPPdr wppdr.idl 

WPQdr wpqdr.idl 



4.4 WPS Classes - Warp Version 4 

The following figure lists the predefined Workplace object 
classes in a hierarchical order. Each branch in the tree 
represents an immediate descendant (subclass) of a Workplace 
object class. The predefined SOM object class, SOMObject, is 
the root class for all SOM object classes, including all 
Workplace object classes. The class definition files (.IDL) can 
be found in the Waip toolkit in ..\TOOLKIT\IDL. 



Class Name 



Class Definition Files 



SOMObject 

-SOMClass 
-SOMClassMgr 

WPClassManager 
-WPObject 

WPAbstract 

— SmartCenter 



I — WPClock 

WPCountry 
I — WPDisk 

WPLaunchPad 
WPKeyboard 
WPMouse 
WPPalette 

- WPColorPalette 

- WPFontPalette 
1 — WPSchemePalette 



somobj .idl 
somcl s. idl 
somcm. idl 
wpclsmgr.idl 
wpobject.idl 
wpabs. idl 
^CENTER. DLL 
wpcl km. idl 
wpctry. idl 
wpdisk. idl 
wplnchpd. idl 
wpkeybd. idl 
wpmouse. idl 
wppalet. idl 
wpcl rpal . idl 
wpfntpal .idl 
wpscheme.idl 
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Class Name 



Class Definition Files 





— WPPower 


wppower. 


dl 




— WPPrinter 


wpprint. 


dl 






— WPRPrinter 


wprprint. 


dl 




— WPProgram 


wppgm. 


dl 




— WPShadow 


wpshadow. 


'dl 






— WPNetLink 


wpnetlnk. 


dl 




— WPShredder 


wpshred. 


dl 




— WPSound 


wpsound. 


dl 




— WPSpecialNeeds 


wpspneed. 


idl 




— WPSpool 


wpspool . 


•dl 




— WPSystem 


wpsystem. 


idl 




■ — WPWinConfig 


wincfg. 


idl 


WPFileSystem 


wpfsys. 


idl 




1 — WPDataFile 


wpdataf . 


idl 






— WPHtml 


wphtml . 


idl 






— WPIcon 


wpicon. 


idl 






— WPImageFile 


wpimage. 


idl 






1 — WPBitmap wpbitmap. 


idl 






— WPMet 


wpmet . 


idl 






— WPPif 


wppif . 


idl 






— WPPointer 


wpptr. 


idl 






— WPProgramFile 


wppgmf . 


idl 






1 — WPCommandFw})emdf . 


idl 






— WPUrl 


wpurl . 


idl 




— WPFolder 


wpfolder. 


idl 






— WPDesktop 


wpdesk. 


idl 






— WPDrives 


wpdrives. 


idl 






— WPHost 


wphost. 


idl 






— WPHwManager 


wphwmgr. 


idl 






— WPMinWinViewer 


wpmwv . 


idl 






— - WPNetgrp 


wpnetgrp. 


idl 






— WPNetwork 


wpnetwrk. 


idl 






— WPRootFolder 


wprootf . 


idl 






— WPServer 


wpserver. 


idl 






— WPSharedDir 


wpshdir. 


idl 






— WPStartup 


wpstart. 


idl 






— WPTemplates 


wptemps. 


idl 






! — WPUrl Folder 


wpurl f dr. 


idl 


WPTransient 


wptrans. 


idl 




— WPJob 


wpjob. 


idl 




— WPDevice 


wpdevice. 


idl 






— WPDevAudio 


wpaudio. 


idl 






— WPDevBus 


wpbus. 


idl 






— WPDevCDRom 


wpcdrom. 


idl 






— WPDevCPU 


wpcpu. 


idl 






— WPDevDiskette 


wpdskett . 


idl 






— WPDevDisplay 


wpdisply. 


idl 






— WPDevHarddri ve 


wphrddrv. 


idl 






— WPDevKeyboard 


wpkeybdd. 


idl 






— WPDevMemory 


wpmem . 


idl 






— WPDevMouse 


wpmoused. 


idl 






— WPDevParallel 


wpparal . 


idl 






— WPDevPeriph 


wpperiph. 


idl 






— WPDevSerial 


wpserial . 


idl 






— WPDevTape 


wptape. 


idl 
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Class Name 



Class Definition Files 



1 — WPDevTimer wptimer.idl 

— WPPort wpport.idl 

— WPPdr wppdr.idl 
I — WPQdr wpqdr.idl 

Note 1: The class definition file name is unknown for the 
SmartCenter class. 



4.5 WPS Objects: Key Values / Pairs 

Setup strings used by SysCreateObjectQ and 
SysSetObjectDataQ must contain a string which is composed 
of a series of "key name = value" pairs that create / change the 
behavior of the object respectively. Key name is not case 
sensitive for the default WPS objects. For example, you can 
specify Title and TITLE interchangeably. However, key name 
values used by other private setup strings, may be case 
sensitive. 

Key names defined below for the WPObject class apply to 
subordinate classes as well (e.g. WPFolder and WPProgram), 
unless overridden. 

Also, SOM/WPS enabled applications can define additional, 
private setup strings. An example is the group of key names 
beginning with SIO_ belonging to Ray Gwinn's SIO / VSIO 
drivers and shown below under DOS Settings. 

The following lists include the "key name = value" pairs that 
have been identified by the author and others. Because of the 
lack of developer related documentation covering the WPS, 
there are probably others which do not appear below. Notes 
concerning these values refer to results obtained with either 
| OS/2 2.1 or OS/2 Warp Version 3 or 4 in ship-level form. 

Furthermore, there is no assurance that all of the values are 
detailed for each key name nor is there an explanation for all 
key names which have been found within the OS/2 DLL's 
where the key name was found to be defined. 

The DOS and WINOS2 Settings values are grouped separately 
in the next section since there are unique characteristics 
associated with them. 
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ultiple key names are separated by semicolons and multiple 
lues for a key name are separated by commas. 



ample: 



" key 1 =va I ue1 ; key2=va L ue2 , va I ue3 ; " 

) specify a literal comma or a literal semicolon inside one of 
e fields an escape character ( A - '5E'x) must precede the 
mma or semicolon. For example: 

A , indicates a literal comma. 
A ; indicates a literal semicolon. 

lie 01: Any changes which are made to an open Settings 
notebook via SysSetObjectDataQ are not necessarily 
reflected in that notebook until it is closed and 
reopened. 

->te 02: If the same key name is specified more than once 
within a setup string, it generally appears as though the 
first key name-value pair is the one which prevails; 
however, tliat is not always the case. 

Jte 03: Some of the alphabetic values, of the key name = value 
pairs, shown below have been found to be case 
sensitive with uppercase being required; therefore, all 
alphabetic values should be created in uppercase. 

?te 04: A new line character, X 0A% can be used to cause a 
value such as Title to occupy more than one litte. 
Also, it appears that the occurrence of the escape 
character, A , also causes a new line to be created; 
however, 2nd and subsequent escape characters used 
for this purpose appear to be ignored. 

some cases, it is not clear whether a setup string key name 
^alue pair was created for Waip Version 4 or whether it 
isted prior to Waip Version 4 and was just not known until 
arp Version 4. Therefore, some of the key name / value 
irs marked (V4) may, in fact, be valid for Waip Version 3. 

jIow are the setup strings identified for the following classes: 
WPColorPalette (V4) 
WPDesktop (V4) 
WPDisk 
WPFolder 

WPFontPalette (V4) 



WPHost 
WPHtml 
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WPKeyboard 

WPLaunchPad 

WPObject 

WPPalette 

WPPdr 

WPPrinter 

WP Prog ram 

WPRPrinter 

WPSchemePalette 

WPUrl 



(V4) 
(V3) 



(V4) 
(V3) 

(V4) 
(V4) 
(V4) 



WPColorPalette 

Key Name Value 



Description 



fV4) 



AUTOSETUP HIRES This sets the number of 

default colors in the 
color palette to the 
256-color Mixed Color 
Palette. 

LORES This sets the number of 

default colors in the 
color palette to the 
16-color Sol id Color 
Palette. 



COLORS 



RGB values These are the initial 
color values of each 
eel 1 in the color 
palette. The values for 
each cell are separated 
by commas. (This is 
equivalent to calling 
the wpSetupCell 
method.) The RGB value 
must be presented as a 
6-digit hex value in 
the format 1 RRGGBB'x 
where RR, GG, and BB 
are the red, green, and 
blue, values ranging 
between 'OO'x and 'FF'x 
(0-255 decimal). 



XCELLCOUNT columns Number of X cells as 

decimal digits. For 
Solid Color Palette, 
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WPColorPalette 

Key Name Value Description (V4) 



AUTOSETUP=LORES must be 
specified, and the 
default value is 8. For 
Mixed Color Palette, 
AUTOSETUP=HIRES must be 
specified, and the 
default value is 16. 



YCELLCOUNT rows Number of Y cells as 

decimal digits. For 
Solid Color Palette, 
AUTOSETUP=LORES must be 
specified, and the 
default value is 2. For 
Mixed Color Palette, 
AUTOSETUP=HIRES must be 
specified, and the 
default value is 16. 



WPDesktop 

Key Name Value 

AUTOLOCKUP YES | NO 



Description (V4) 

Specifies the status of 
the auto-lockup 
feature. If set, the 
keyboard and mouse will 
automatically lock up 
after the specified 
number of minutes of 
inactivity. 



LOCKUPAUTODIM YES | NO Specifies the status of 

the autodim feature. If 
set, the screen blanks 
out and a floating lock 
icon is displayed 2 
minutes after the . 
keyboard and mouse are 
locked. 
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WPDesktop 

Key Name Value 

LOCKUPBACKGROUND 
N 



M 



S 
B 



Description (V4) 

Image file name; This 
name must be the fully- 
qualified path of the 
image file. "?:\" is 
permitted to indicate 
the boot drive. A value 
of (none) can be used 
to indicate the absence 
of an image file. 

Image mode; This mode 
can be one of the 
fol lowing: 
N = Normal image 
T = Titled image 
S = Scaled image 

Scaling factor. 

Background type; This 

can be one of the 

fol 1 owing: 

I = Image 

C = Color only 

Background color; This 
color can be 3 numbers 
representing RGB values 
(red, green, blue). 



Example: 

"BACKGROUND 3 ? : \0S2\B I TMAP\OS2LOGO . BMP , S , 3 , I » 
or 

"BACKGROUND=(none) f , ,C,255 222 255" 
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WPDesktop 
Key Name 



Value 



Description 



JV4I 



LOCKUPFULLSCREEN 



YES | NO Specifies whether the 
entire screen is taken 
up by the lockup 
background image. The 
lockup background 
specified by the 
LOCKUPBACKGROUND 
keyname is displayed 
when the system locks 
the keyboard and mouse. 
Otherwise, when the 
system locks up, a 
message box is to be 
displayed prompting you 
to enter your lockup 
password. 



LOCKUPONSTARTUP YES | NO 



Specifies whether or 
not the keyboard and 
mouse are automatically 
locked when the system 
is started or 
restarted. 



LOCKUPSCREENSAVERMOOE 

YES | NO Specifies whether or 
not a password is 
required to unlock the 
keyboard and mouse. YES 
indicates that the 
lockup facility acts 
like a screen saver 
without a password 
being required. NO 
indicates that a 
password is required to 
unlock the keyboard and 
mouse 

LOCKUPTIMEOUT 3 Specifies the number of 

minutes of keyboard and 
mouse inactivity that 
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WPDesktop 
Key Name 



Value 



Description 



will cause the system 
to automatically lock 
the keyboard and mouse. 
Value can range from 1 
to 99. 



WPDisk 
Key Name 



Val ue 



Description 



DRIVENUM 



Logical drive number 
(1-26). 



WPFolder 
Key Name 



Value 



Description 



ALWAYSSORT (V3) 
NO | YES Indicates whether 

contents of the folder 
should be displayed in 
sorted order. 



| (OS/2 2.1) 

BACKGROUND file name 



Defines the folder 
background. Filename 
is the name of a file 
in the \0S2\BITMAP 
directory of the boot 
drive or the full file 
system name of any 
other .BMP file. 



Note 01: There is no method for altering the 
other background characteristics for 
a folder (e.g. image vs. color; 
normal, 'scaled or tiled image; etc.) 
using either SysCreateObjectQ or 
SysSetObjectData() . 

Note 02: There is no method for altering 

"Always maintain sort order" using 
either SysCreateObjectQ or 
SysSetObjectDataf) . 
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WP Folder 
Kev Name 



Value 



Description 



| (Warp) 
BACKGROUND 



(V3) 

N,M,S,B,C Set folder background, 
where: 



Image file name; This 
name must be the fully- 
qualified path of the 
image file. "?:\" is 
permitted to indicate 
the boot drive. A value 
Of (none) can be used 
to indicate the absence 
of an image file. 

Image mode; This mode 
can be one of the 
fol lowing: 
N = Normal image 
T = Titled image 
S = Scaled image 



Scaling factor. 

Background type; This 

can be one of the 

following: 

I = Image 

C = Color only 



C Background color; This 

color can be 3 numbers 
representing RGB values 
(red, green, blue). 

Example: 

l, BACKGROUND=? : \OS2\B I TMAP\OS2LOGO . BMP , S , 3 , 1 '» 



»BACKGROUND=(none),,,C,255 222 255" 
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WPFolder 
Key Name 



Val ue 



Description 



DEFAULTSORT 



Sets the default sort 
value for the folder 
according to number. 



DEFAULTVIEW 



DETAILSCLASS 



-2 
-1 

0 

5 
6 
7 
9 

11 



ICON 



Name 
Type 

Folder's popup first 
item 

Real name 
Size 

Last write date 
Last access date 
Creation date 

(V3) 

Sets the default open 
view to the ICON (or 
CONTENTS) view. 



TREE Sets the default open 

view to the TREE view. 

DETAILS Sets the default open 

view to the DETAILS 
view. 

DEFAULT Restores the default 

view to its original 
value by undoing any 
previously selected 
setting. 

blank Sets the default open 

view to the view of the 
containing folder. 

(V3) 

classname Set object class for 
which the details are 
displayed in details 
view. The default 
object class is 
WPFileSystem. 
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WPFolder 

Key Name Value Description 



DETAILS FONT font size & Setup string used to 
face name define the font 

associated with the 
icon details of the 
folder. For example: 
8.Helv. 



DETAI LSSHADOWCOLOR 

color 



DETAI LSTEXTCOLOR 



color 



(V4) 

Set color of the text 
for a shadow object in 
details view. The color 
value may be the name 
of a color or 3 numbers 
representing RGB values 
(red, green, blue) . 



(V4) 

Set the color of the 
text for a normal 
object in details view. 
The color value may be 
the name of a color or 
3 numbers representing 
RGB values (red, green, 
blue). 



DETAI LSTODISPLAY (V4) 
index [,...] Set details to be 

displayed for a given 
class. The index is the 
column index, starting 
at 0, of the field to 
display. For example, 
"DETAILST0DISPLAY=0,2" 
specifies that only the 
first and third details 
data items are to be 
displayed. The default 
value is to display all 
fields. 
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WPFolder 

Key Name Val ue Description 



DETAILSVIEW style Set details view to a 

specified view style 
from the following: 



NORMAL 



Normal size icons. 



MINI 



Small icons. 



Note 01: There is no equivalent notebook tab 
setting for DETAILSVIEW which 
provides the above option. 

Note 02: MINI is an example of one of the key 
word values found to be case 
sensitive. 



ICONFILE 



index, fi le_name 



(V3) 



File_name is a full 
file system name used 
to set the file name of 
the animation (closed 
folder) icon. The 
"index" value must be 
set to 1. The specified 
file contains the 
folder's closed folder 
i con . 



I CON FONT 



font size & 
face name 



Setup string used to 
define the font 
associated with the 
icon view of the 
folder. For example: 
8.Helv. 



ICONGRIDSIZE 



h.v 



(V4) 

This value sets the 
horizontal and vertical 
icon view spacing 
within a folder. It has 
a range of 0 to 999 
pixels. 
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WPFol der 

Key Name Value Description 



Note: The default values appear to vary by 

screen resolution. 

ICONNFILE index, fi lejiame (V3) 

Filename is a full 
file system name used 
to set the file name of 
the animation (open 
folder) icon. The 
"index" value must be 
set to 1. The specified 
file contains the 
folder's open folder 
i con . 

ICONNRESOURCE index, id, module (V3) 

Set resource of the 
animation (open folder) 
icon. The index value 
must be set to 1. The 
id is the identity of 
an icon resource in the 
module dynamic link 
library (DLL). The 
specified resource is 
the folder's open 
folder icon. 



ICONPOS x,y 



Set object's initial 
icon position. The x 
and y values represent 
the center of the 
icon's position in the 
object's folder in 
percentage coordinates. 



Note: Appears to be functional only with 
SysCreateObjectQ when creating a 
new object. 
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WPFolder 

Key Name Va] ue Description 

ICONRESOURCE id, module Set object's icon. ID 

is the identity of an 
icon resource within 
the module dynamic link 
library (DLL). 

Note: If both ICONFILE and ICONRESOURCE 

ore specified in the same setup 
string, ICONFILE prevails. 



IC0NSHAD0WC0L0R 

color 



ICONTEXTBACKGROUNDCOLOR 
color 



ICONTEXTCOLOR 

color 



[ ICONTEXTVISIBLE 



(V4) 

Set color of the text 
associated with the 
shadow icons in icon 
view. The color may be 
the name of a color or 
3 numbers representing 
RGB values (red, green, 
blue). 

(V4J 

Set color of the 
background for all text 
displayed in icon view, 
tree view, and details 
view. The color may be 
the name of a color or 
3 numbers representing 
RGB values (red, green, 
blue). 

(V4) 

Set color of the text 
associated with normal 
icons in icon view. The 
color may be the name 
of a color or 3 numbers 
representing RGB values 
(red, green, blue). 

(V4) 
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WPFolder 

Key Name Value Description 



I CON VIEW 



Note: 



ICONVIEWPOS 



Note: 



YES | NO 
sl[,s2,...sn] 

FLOWED 
NON FLAWED 
NONGRID 
NORMAL 
MINI 

INVISIBLE 



Set icon view text 
visibility property in 
icon view. 



Set icon view to a 
specified view style 
from the following: 

Flowed icon view. 

Non-flowed icon view. 

Non-gridded icon view. 

Normal size icons. 

Small icons. 

No icons. 



When these values are combined, they 
are separated with a comma (e.g. 
FLOWED, MINI). 

xl,yl,x2,y2 XI and yl are the 

percentage coordinates 
representing the 
position of the lower 
left corner of the 
window containing the 
i con . 

X2 and y2 represent the 
percentage values of 
the width and height 
respectively of the 
window containing the 
i con . 

Appears to be functional only with 
SysCreateObjectQ when creating a 
new object. 
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WPFolder 
Key Name 

MENUBAR 

YES | NO 



OPEN SETTINGS 



DEFAULT 



ICON 



TREE 



DETAILS 



(V4) 

Determines whether the 
menu bar is present in 
an open view of the 
folder. The menu bar is 
the area beneath the 
title bar and normally 
contains Folder, Edit, 
View, . .. 

Open settings view when 
object is created with 
SysCreateObjectO or 
modified with 
SysSetObjectDataO- 

Open default view when 
object is created with 
SysCreateObjectO or 
modified with 
SysSetObjectDataO- 

Icon view wi 1 1 be 
opened when object is 
created with 
SysCreateObjectO or 
modified with 
SysSetObjectDataO- 

Tree view will be 
opened when object is 
created with 
SysCreateObjectO or 
modified with 
SysSetObjectDataO . 

Details view will be 
opened when object is 
created with 
SysCreateObjectO or 
modified with 
SysSetObjectDataO. 
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WPFolder 
Key Name 



Value 



Description 



REMOVEFONTS (V3) 
NO | YES Indicates whether 

instance fonts should 
removed from the 
folder. 



SHOWALLINTREEVIEW 
YES 



(V4) 

NO Determines whether all 
objects are shown in 
tree view or just other 
folders are shown. 



SORTBYATTR . (V4) 
il[,12...in] Define the index list 
of sort attributes used 
to sort the details 
vi ev of the folder. 
Index list is a comma- 
delimited list from the 
following values: 



SORTCLASS 



TREEFONT 



classname 



font size & 
face name 



Name 
Type 

Real name 
Size 

Last write date 
Last access date 
Creation date 

(V3) 

Set class object to 
sort by. The default 
class object is 
WPFileSystem. 

Setup string used to 
define the font 
associated with the 
tree view of the 
folder. For example: 
8.Helv. 



TREESHADOWCOLOR 



(V4) 
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WPFol der 

Key Name Value Description 



color 



TREETEXTCOLOR 

color 



TREETEXTVISIBLE 

YES | NO 



TREEVIEW style 

LINES 

NOLINES 

NORMAL 



Set color of the text 
for a shadow object in 
tree view. The color 
value may be the name 
of a color or 3 numbers 
representing RGB values 
(red, green, blue). 

(V4) 

Set color of the text 
for a normal object in 
tree view. The color 
value may be the name 
of a color or 3 numbers 
representing RGB values^ 
(red, green, blue). 

(V4) 

Set tree view text 
visibility property in 
icon view. 

Set tree view to a 
specified view style 
from the following: 

Lines in tree view. 

No lines in tree view. 

Normal size icons in 
tree view. 



MINI Small icons in tree 

v i ew . 

INVISIBLE No icons in tree view. 

Note: When these values are combined, they 

are separated with a comma (e.g. 
LINES, NORMAL). 
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WPFolder 

Key Name Val ue 



Description 



WORKAREA NO | YES Indicates whether the 

folder will be a 
workarea folder. 



WPFontPalette 

Key Name Val ue 

AUTOSETUP YES 



Description (V4) 

Specifies that the font 
palette is to be 
reinitialized with the 
default set of fonts. 



FONTS fonttype 



Example: 

'FONTS=10. Helvetica/ 
'9.WarpSans # ' 
'10. System;' 

XCELLCOUNT columns 



YCELLCOUNT rows 



These are the initial 
fonts for each cell in 
the font palette. The 
values for each cell 
are separated by 
commas. (This is 
equivalent to calling 
the wpSetupCell 
method.) The fon t type 
value is presented as 
the point size followed 
by a period which is 
then followed by the 
face name. 



1 1 
1 1 ' 



Number of X cells as 
decimal digits. If not 
specified, defaults to 
2. 

Number of Y cells as 
decimal digits. If not 
specified, defaults to 
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WPHost 

Key Name Value Description (V4) 



HOSTNAME hostname 



USERNAME username 



PASSWORD password 



ACCOUNT account 



Set the hostname to be 
accessed using an FTP 
Host object. This value 
is designated in the 
"Hostname" field on the 
Host page. For example: 
ftp.cfsrexx.com 

Set the username to be 
used when accessing a 
hostname using an FTP 
Host object. This value 
is designated in the 
"Username" field on the 
Host page. 

Set the password to be 
used to access the 
given host with a given 
username. This value is 
designated in the 
"Password" field on the 
Host page. This value 
is not required when 
the object is created. 

If one is not 
specified, the user 
will be prompted to 
enter a password when 
the host is accessed. 
If specified, passwords 
are stored in an 
encrypted form when 
set. 

Set the account value 
to be used when 
accessing a given 
hostname or username 
using the FTP Host 
object. This value is 
designated in the 
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WPHost 

Key Name Value Description (V4) 



"Account" field on the 
Host page. 

This value is required 
only when the FTP 
server being accessed 
maintains account 
information for host 
accesses. 



Set the default file 
transfer mode for an 
FTP Host object. This 
value is designated by 
selecting the ASCII 
"Default download type" 
radio button on Host 
page 1. 

BINARY This is the default 

file transfer mode. 
This value is 
designated by selecting 
the BINARY "Default 
down- load type" radio 
button on Host page 1. 

REM0TED1R path Specify which directory 

will be used as the 
initial working 
directory when 
connecting to a host 
system using the 
specified FTP Host 
object. For example: 
e:\publ ic\bin, . , 

This value is 
designated in the 
"Preferred remote 
directory" field on the 
Host page 2. The syntax 



FILETRANSFERTYPE 

ASCII 
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WPHost 

Key Name Value Description 



of this path 
specification must be 
in a format understood 
by the remote host's 
operating system. The 
given username and 
account must have 
permissions set to 
access this directory 
on the remote host. 

LOCALDIR path Specify the directory 

to be used as the 
default download 
directory for GET 
operations using the 
FTP Host object if one 
is not explicitly 
indicated. This value 
is designated in the 
"Preferred local 
(download) directory" 
field on Host page 2. 

INCLUDE pattern This is used to filter 

remote files and 
directories from the 
FTP Host object's open 
views. This value is 
designated in the "Onl 
display files matching 
pattern" field on the 
Include page. The 
1 syntax of the pattern 

must be understood by 
the remote host's 
operating system. 
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WPKeyboard 

Kev Name Value Description £V4l 



CursorBlinkRate ^1 



EditTitleTextKey 
0 



KeyRepeatDelay ^1 



i 

KeyRepeatRate 0 



PopUpMenu 0 



Sets the rate at which 
the cursor blinks. This 
value must be in the 
range 0 to 890 where 
890 is the slowest. 



Key combination used to 
edit title text for an 
object. The default key 
pair is <Shift-F9>. 

Sets the time before 
the key starts 
repeating. This value 
must be in the range 0 
to 890. 

Sets the rate at which 
a key repeats. This 
value must be in the 
range 1 to 20. 

Key combination used to 
activate a object's 
context sensitive menu. 
The default key pair is 
<Shift-F10>. 



©1993-1997 by C F S Nevada, Inc. 



147 



Rev 4.0 



WPLaunchPad 

Key Name Value Description (V3) 



DRAWEROBJECTS n, object [, ...] 

A comma delimited list, 
each of which 
represents a drawer 
number followed by 
either object IDs or 
fully qualified path 
names. The drawer 
number (0 = LaunchPad 
itself, 1 = first 
drawer, etc.) is 
separated from the 
object name with a 
comma. 

FPOBJECTS <object ID> | file_name [, ...] 

A comma delimited list 
of objects to be added 
to the end of the 
LaunchPad. The value(s) 
for this key name 
is/are object IDs or 
fully qualified path 
names. 

Note: This is equivalent to specifying 

DRAWEROBJECTS with a drawer number 
of 0. 



LPACTIONSTYLE TEXT 
MINI 
NORMAL 
OFF 



Display action buttons 
as text. 

Display action buttons 
as mini icons. 

Display action buttons 
as normal sized icons. 

Do not display action 
buttons. 
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WPLaunchPad 

Key Name Val ue 



Description [V31 



LPCLOSEDRAWER NO | YES 



LPDRAWERTEXT NO | YES 



LP FLOAT NO | YES 



LPHIDECTLS YES | NO 



LPSMALLICONS NO | YES 



LPTEXT NO | YES 



LPVERTICAL NO | YES 



Specifies whether a 
drawer should be closed 
after a LaunchPad 
object is opened. 

Specifies whether 
object titles should be 
displayed on the 
LaunchPad drawers (not 
buttons) . 

Specifies whether the 
LaunchPad should float 
to the top of other 
windows. 

Specifies whether the 
LaunchPad frame 
controls (i.e. title 
bar and icon) should be 
hidden. 

Specifies whether small 
icons or default size 
icons should be 
displayed on the 
LaunchPad. 

Specifies whether 
object titles should be 
displayed on the 
LaunchPad buttons (not 
drawers) . 

Specifies whether the 
LaunchPad should be 
displayed horizontally 
or vertically. 



Note: It is not possible to add objects to the 

LaunchPad under REXX. The LaunchPad 
must be recreated with any new objects 
included in the setup string. 
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WPObject 

Key Name Value Description 



CCVIEW 



DEFAULT 



YES 



The system default 
value of the concurrent 
view setting of the 
system is used when the 
user selects Open. (V3) 

New or additional 
(concurrent) views of 
this object will be 
created every time the 
user selects open. 



NO 



Open views of this 
object will resurface 
when the user selects 
open. 



DEFAULTVIEW (V3) 
SETTINGS Set default open view 
to Settings view. 



id 



Set default open view 
to the ID of a user- 
added view. 



HELPLIBRARY filename Filename is a full 

file system name used 
to set the file name of 
the help library. 

HELPPANEL id Set object's default 

help panel . 



HIDEBUTTON 



NO 



Views of this object 
will have a minimize 
button as opposed to a 
hide button. 



YES Views of this object 

will have a hide button 
as opposed to a 
minimize button. 
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WPObject 

Key Name Value Description 



Note: HIDEBUTTON=YES appears to be 

equivalent to an older setting of 
VIEWBUTTON=HIDE. HIDEBUTTON-NO 
appears to be equivalent to an older 
setting of VIEWUTTON=MINIMIZE. 



ICONFILE file name 



Filename is a full 
file system name used 
to define the object's 
i con . 



ICONPOS x,y Set object's initial 

icon position. The x 
and y values represent 
the center of the 
icon's position in the 
object's folder in 
percentage coordinates. 



ICONRESOURCE id, module Set object's icon. ID 

is the identity of an 
icon resource within 
the module dynamic link 
library (DLL). 



Note: If both ICONFILE and ICONRESOURCE 

are specified in the same setup 
string, ICONFILE prevails. 

Note: Appears to be functional only with 
SysCreateObject() when creating a 
new object. 



LOCKEDINPLACE NO | YES 



(V4) 

If locked in place is 
set, the object's icon 
is fixed in position in 
an open icon view of 
the folder containing 
the object. 
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WPObject 

Key Name Value Description 



MENUITEMSELECTED 

menu item 



MENUS 

LONG | 



MINWIN DESKTOP 



(V4) 

Simulates selecting the 
specified menu_item 
from the object's popup 
menu. 

(V4) 

Set the object's 
popupmenu to long or 
short format. Short 
menus will not include 
Help and Create Shadow. 

Views of this object 
will minimize to the 
Desktop when their 
minimize button is 
selected. 



VIEWER Views of this object 

will minimize to the 
minimized window viewer 
when their minimize 
button is selected. 



HIDE 



NOCOPY NO | YES 



NODELETE NO | YES 



NODRAG NO | YES 



Views of this object 
will hide when their 
minimize button is 
selected. 

Resets / sets the 
object's no copy 
property. 

Resets / sets the 
object's no delete 
property. 

Resets / sets the 
object's no drag 
property. 
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WPObject 

Kev Name Value Description 



NODROP 



NO | YES 



Note: 



NOLINK 



NOMOVE 



Note: 



Resets / sets the 
object's no drop 
property. When set, no 
other object can be 
dropped on it. 



Appears in PMWP.DLL but does not 
appear to be functional. 



NO | YES 



NO | YES 



Resets / sets the 
object's no link 
property. 

Resets / sets the 
object's no move 
property. 



The NOMOVE property does not inhibit 
an object from being dragged within 
its current container (i.e the 
desktop or a folder). It results in 
a copy rather than a move if the 
object is dragged to another 
container. 



NOPRINT 



NO | YES 



Resets / sets the 
object's no print 
property. 



NORENAME NO | YES Resets / sets the 

object's no rename 
property. 

NOSETTINGS (V3) 
NO | YES Resets / sets the 

object's no settings 
property, so that the 
object's settings 
cannot be opened. 
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WPObject 

Key Name Val ue Description 



NOSHADOW NO | YES 



NOTVISIBLE NO | YES 



OBJECT ID <name> 



Note 01: 



Note 02: 



OPEN SETTINGS 



DEFAULT 



Resets / sets the 
object's no shadow 
creation property. 

Resets / sets the 
object's not visible 
property. 

Defines the object's 
identity. The object ID 
will stay with the 
object even if it is 
moved or renamed. An 
object ID is any unique 
string preceded with a 
'<' and terminated with 
a '>'. 



Open settings view when 
object is created with 
SysCreateObject() or 
modified with 
SysSetObjectData(). 

Open default view when 
object is created with 
SysCreateObjectQ or 
modified with 
SysSetObjectDataQ. 



Prior to Warp Version 3, when 
including the " OBJECT I D-<. . .>" 
keyname /value pair in a setup 
string, it must be specified as the 
last entry in the string. 

Prior to Warp Version 3, an OBJECTID 
should not be assigned to an object 
defined as a TEMPLATE since this 
would lead to multiple objects with 
the same OBJECTID. 
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WPObject 

Key Name Value Description 



SHADOWID <object ID> 



| filejname 
Specifies the object 
for which this object 
is a shadow of. The 
value for this key name 
is an object's object 
ID or a fully qualified 
path name of a 
directory, program 
file, or data file. 



TEMPLATE NO | YES Resets / sets the 

object's template 
property. 



Note: Prior to Harp Version 3, an OBJECTID 
should not be assigned to an object 
marked as a template since this 
would lead to multiple objects with 
the same OBJECTID. 



Set object's title. 



Description 



(V4) 



Number of columns of 
cells. If not 
specified, defaults to 
13. 



Number of rows of 
cells. If not 
specified, defaults to 
9. 



TITLE 



Title 



WPPalette 
Key Name 



XCELLCOUNT 



Value 



columns 



YCELLCOUNT rows 



XCELLWIDTH width 
YCELLHEIGHT height 



Width in dialog units 
of each cell . 

Height in dialog units 
of each eel 1 . 
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WPPalette 



Key Name 


Value 


Description fV4) 


XCELLGAP 


gap 


X separation in dialog 
units between each 
cell. 


YCELLGAP 


gap 


Y separation in dialog 
units between each 
cell. 


WPPdr 
Key Name 


Value 


Description (V4) 


INSTPATH 


path 


Indicates the name of 



the install directory. 
When the printer driver 
object is created, and 
the driver is not 
already installed, the 
required driver will be 
installed from this 
f \^ path. 

PORTNAME port_name \ Specifies the port name 

required by the Windows 
printer driver. 
Port^name may be one of 
the following values: 
C0M1, COM2, COM3, COM4, 
FILE, LPT1, LPT2, LPT3. 

Note: The W1N0S2 keyname (page 157) for 

this object should also be specified 
when using this keyname. 

PRINTDRIVER driver_name Specify the full driver 

name for the printer 
driver object. A full 
driver name is in the 
driver. device format. 
For example: 
IBM42XXX. IBM 4201 
Proprinter III 
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I WPPdr 

j Key Name Value Description (V4) 

PROMPT YES | NO Specifies whether or 

not the user should be 
prompted for 
installation diskettes. 

When creating a printer 
driver object, and the 
required driver is not 
already installed, the 
user will be prompted 
for printer driver 
installation diskettes. 

WIN0S2 YES | NO Specifies whether or 

not the WIN0S2 (or 
Windows) driver should 
1 also be installed when 

creating the OS/2 
printer driver object. 
The PORTNAME keyname 
should also be 
specified when using 
this keyname. 



WPPrinter 

Key Name Vaj ue Description fV3) 

APPDEFAULT YES | NO This PrintObject is, or 

is not, to become the 
application's default 
PrintObject for 
printing. 

DEFAULTVIEW DETAILS | ICON 

Specifies the default 
open view for this 
PrintObject. 
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WPPrinter 

Key Name Value Description (V3) 

JOBDIALOGBEFOREPRINT 

NO | YES Specifies whether the 
job properties dialog 
is displayed before 
printing. 

JOBPROPERTIES filename The complete path to a 

binary file containing 
the default job 
properties for this 
PrintObject. This file 
can be created by 
saving the 

PRQINF03~>pDriverData 
data to a file; this 
data can be obtained by 
using the SplQueryQueue 
API of the spooler. 

f \ For more information 
\about spooler 
functions, see the 
Presentation Manager 
Programming Reference. 



OUTPUTTOFILE NO | YES 



PORTNAME portname 



Specifies if the output 
of this PrintObject 
goes to a file. The 
user will be prompted 
for a file_name each 
time a print job is 
submitted to this 
PrintObject. 

The names of already 
instal led ports (i .e 
LPTx, COMx) to which 
this PrintObject is to 
be attached. In the 
case of more than one 
port, specify a 
comma-separated list. 
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WPPri titer 

Key Name Vaj ue Description (V3) 



PRINTDRIVER driver. device 

The complete name of 
the print driver that 
this PrintObject is to 
use. For example: 
1 IBM42XX. IBM 420 
Proprinter III 1 , 
•LASERJET. HP LaserJet 
Series IT. In the case 
of more than one print 
driver, specify a 
comma-separated list. 
These printer drivers 
must already be 
installed. j 

PRINTERSPECIFICFORMAT 

YES The PrintObject spools 

print jobs in PM_Q_RAW 
format. 



PRINTWHILESPOOLING 

NO | YES 



QSTARTTIME time 



QSTOPTIME time 



The PrintObject spools 
print jobs in 
PMJ)_STANDARD format. 

Printing is not, or is, 
enabled while the job 
is spooling. 

The time when the 
PrintObject starts 
printing. The time 
format is HH:MM, and 
the base is a 24-hour 
clock. 

The time when the 
PrintObject is to stop 
printing. The time 
format is HH:MM, and 
the base is a 24-hour 
clock. 
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WPPrinter 

Key Name Value Description (V3) 



QUEUENAME queue_name The local queue_name 

for the PrintObject. If 
a queue name is not 
specified, one is 
created by the 
PrintObject. The 
queue^name key will be 
ignored if this object 
has already been 
assigned a queue. 

QUEUEDRIVER qdrvname The queue driver name. 

The queue driver must 
already be installed 
and will usually be 
PMPRINT. 



SEPARATORFILE file name 



SYNCJOBPROP YES | NO 



A separator file that 
prints before each 
print job. 

(V4) 

Indicates whether the 
default properties of 
the printer object are 
to be synchronized with 
the network's printer 
job properties. 




SYNCPRINTERPROP YES I NO 



(V4J 

Indicates whether the 
printer properties of 
the printer object are 
to be synchronized with 
the network's printer 
properties. 



TAKEDEFAULTS YES | NO 



(V4) 

Indicates whether the 
printer object takes 
the default values when 
it is created. When 
default values are not 
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WPPrinter 
Kev Name 



Value 



Description 



mi 



used, a Create a 
Printer dialogue will 
be displayed. 



WP Program 

Kev Name Val ue Description 

(Key names which are applicable to the WPProgram 
class and not the WPProgramFile class are indicated 
with the character p .)( 



ASSOCFILTER filters 

ASSOCTYPE type 
Note: 

EX EN AM E filejname 

MAXIMIZED p YES 

MINIMIZED p YES 

NOAUTOCLOSE YES 
NO 

Note: 



Sets the filejiame 
filter for files 
associated to this 
program. Multiple 
filters are separated 
by commas. 

Sets the type of files 
associated with this 
program. Multiple types 
are separated by 
commas . 



Sets the name of the 
program to filejname. 

Start program 
maximized. 

Start program 
minimized. (See the 
note following 
NOAUTOCLOSE below.) 

Leaves the window open 
upon program 
termination. 

Closes the window when 
the program terminates. 



Under OS/2 2.11, NOAUTOC LOSE-NO (if 
specified) overrides MINIMIZED=YES. 
That is, if the former is explicitly 
specified, MINIMIZED will be forced 
to NO. Therefore, if MINIMI ZED-YES 



By appending two commas (,,) to each 
of the above parameters, any 
existing settings are preserved. 
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WPProgram 

Key Name Value Description 



is desired, don't specify 
NOAUTOCLOSE=NO (which is the default 
anyway) . 

OPEN p SETTINGS Open settings view when 

object is created with 
SysCreateObjectQ or 
modified with 
SysSetObjectDataQ . 

DEFAULT Open default view when 

object is created with 
SysCreateObject() or 
modified with 
SysSetObjectDataQ. 

Note: If SETTINGS is specified, the 

program object's notebook is opened; 
however, if DEFAULT is specified, 
the program object is launched (its 
icon is cross-hatched) and the 
program appears in the ta^fTTist but 
it does not come to the foreground 
without either a second call to 
SysSetObjectData() or manual 
intervention unless the DeskMon/\2 
extensions are installed on the 
system. 



PARAMETERS params Sets the parameter list 

to params. Params can 
be any user-supplied 
string including 
substitution values 
which can be any of the 
fol lowing: 

% Indicates that no 

parameters (including a 
default of the full 
file system name) are 
to be passed to the 
program. 

%* Insert the full file 

system name. 

%**P Insert drive and path 

information without the 
last backslash (\) . 

%**D Insert drive with ' :' 

or UNC name. 
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WPProgram 

Kev Name Val ue 



Description 



%**N Insert file name 

without extension. 

%**F Insert file name with 

extension. 

%**E Insert extension 

without leading dot. In 
HPFS, the extension 
always comes after the 
last dot. 

[ ] Results in the user 

being prompted, via a 
dialogue box, to enter 
a parameter string. The 
dialogue box contains 
the title "Specify 
Parameters" and shows 
the full file system 
name of the program. 
(The results are 
identical whether there 
are, or are not, any 
spaces between the 
brackets.) 

[prompt] Same as with brackets 
above along with prompt 
being added to the 
dialogue box. 

Note: If you try to start a program from 

the pop-up menu of a folder and the 
program does not start or displays 
an error message, you can stop the 
name of the folder from being sent 
to the program by placing a percent 
sign (%) in the parameter field. 

PROGTYPE p PM Sets the session type 

to PM. 

FULLSCREEN Sets the session type 
to OS/2 full screen. 

WINDOWABLEVIO 

Sets the session type 
to OS/2 windowed. 

VDM Sets the session type 

to DOS full screen. 
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WPProgram 

Key Name Val ue Description 



WINDOWEDVDM 



Sets the session type 
to DOS windowed. 



WIN 



WINDOWEDWIN 



SEPARATEWIN 



Sets the session type 
to WIN-OS/2 full screen 
in 3.1 standard mode. 

Sets the session type 
to WIN-OS/2 windowed. 

Sets the session type 
to WIN-OS/2 window 
running in a separate 
VDM. 



PR0G_31_STD Sets the session type 
to standard WIN-OS/2 
full screen. 



PR0G_31_ENH Sets the session type 
to enhanced WIN-OS/2 
full screen. 



PR0G_31_ENHSEAMLESSVDM X 
Sets the session type) 
to enhanced WIN-OS/2 j 
windowed, separate / 
session. / 

PR0G_31_ENHSEAMLESSC0MM0N 

Sets the session type 
to enhanced WIN-OS/2 
windowed, common 
session. 

The DOS I WIN-OS/2 Settings are detailed in the next section. 
Those key names apply to the WPProgram class only. 



SET key name / value 

Key name is the name of 
any environment 
variable and value is 
the string assigned to 
the environment 
variable for that 
session. 



Note 01: The use of the SET key name / value 
pair results in all default 
environment variables for the 
session, except WP_OBJHANDLE= and 
COMSPEC=, to be cleared and only 
those two along with explicitly set 
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Ke y Name Value Description 



variables will exist for the 
session. 

Note 02: Can be used to extend the PATH= 
environment variable for a 
particular session; however, all 
semicolons contained within the 
string must be escaped with a carat 
( M ) and the terminating semicolon 
must be present. For example: 

SET PATH=D:\OS2 A ;D:\OS2\SYSTEM A ;OS2\MDOS A ; ; 



STARTUPDIR pathname 
WPRPrinter 

Kev Name Value 

ICON filejiame 

NETID <network> 

REFRESHINTERVAL seconds 

SHOWJOBS ALL 
OWN 



Sets the working 
directory to pathname. 



Description (V4) 

The name of the .ICO 
file to be used as the 
icon for this object. 

The full name of the 
printer resource as it 
is known to the 
network. For example: 
LS : \\DEPTSERV\DEPTPRNT 
The NETID key will be 
ignored and FALSE will 
be returned if this 
object has already been 
assigned a Netld. 

Time interval , in 
seconds, when the 
printer object is 
refreshed. 

All jobs are displayed 
in the printer object. 

Only the current user's 
jobs are displayed in 
the printer object. 
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WPRPrinter 

Key Name Val ue 



Description 



mi 



TAKEDEFAULTS YES | NO (V4) 

Indicates whether the 
printer object takes 
the default values when 
it is created. When 
default values are not 
used, a Create a 
Printer dialogue will 
be displayed. 



WPSchemePalette 

Key Name Value Description (V4) 

AUTOSETUP YES | NO This aiftomatical ly sets 

the palette values to 
the original system 
palette/settings 
otherwise the original 
system palette settings 
are ignored. 



SCHEMES Scheme_type 



These are the initial 
schemes for each cell 
in the scheme palette. 
The values for each 
cell are separated by 
commas. (This is 
equivalent to calling 
the wpSetupCell 
instance method.) The 
scheme_type value is 
presented as the scheme 
name followed by a 
colon, followed by an 
application name in the 
INI file. 



XCELLCOUNT columns Number of X cells as 

decimal digits. If not 
specified, defaults to 
4. 
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WPSchemePal ette 

Key Name Value Description (V4) 

YCELLCOUNT rows Number of Y cells as 

decimal digits. If not 
specified, defaults to 
7. 

Example: 

SetupSt r i ng= 1 SCHEMES=Marb I e : PM_Ma rbt e_Co lors, ' 
' Southwest : PM_Southwes t_Co I ors , ' 
'Khaki :PMJChaki_Colors; ' 



WPUrl 

Key Name Value Description (V4) 

BROWSER name or pathname 

Specifies the 
executable that will be 
invoked to display the 
web page designated in 
the "Url" field. This 
field can be either a 
pathname or a name of a 
browser in the PATH. 
EXPLORE. EXE is the 
default browser for 
OS/2 Warp. The Java 
applet viewer 
(APPLET.EXE) can be 
used here to view Java 
applets with the URL 
object, but be sure to 
set the "Integrated 
browser" check box on 
the Browser page to NO, 
because APPLET.EXE does 
not understand the URL- 
specific browser 
options. 

DEFAULTBROWSER name or pathname 

This sets the default 
value for BROWSER for 
all URL objects. This 
value will be placed in 
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WPUrl 

Key Name Vaj ue Description (V4) 



the "Path and file 
name" field on the 
Browser page of a URL's 
properties notebook 
when the Default push 
button is pressed and 
when the URL object is 
first created. Also see 
the definition for 
BROWSER (page 167). 

DEFAULTDISPLAYIMAGES 

YES | NO This sets the default 

value for DISPLAYIMAGES 
for all URL objects. 
This value is used for 
the "Display images 
while loading" check 
box of a URL's 
properties notebook 
when the Default push 
button is pressed or 
when the URL object is 
first created. When 
this keyname is set to 
YES, the "Display 
images while loading" 
check box is checked. 
Also see the definition 
for DISPLAYIMAGES (page 
173). 
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| Key Name Val ue 

DEFAULTEMAI LADDRESS 

address 



DEFAULTENABLEPROXY 

NO | YES 



DEFAULTENABLESOCKS 

NO | YES 



Description (V4) 



This sets the default 
value for EMAI LADDRESS 
for all URL objects. 
This value will be 
placed in the 
"Electronic mail 
address" field on the 
Server page of a URL's 
properties notebook 
when the Default push 
button is pressed and 
when the URL object is 
first created. Also see 
the definition for 
EMAI LADDRESS. 



This sets the default 
value for ENABLEPROXY 
for all URL objects. 
The "Proxy gateway" 
check box on the Server 
page of a URL's 
properties notebook is 
checked when the 
Default push button is 
pressed and when the 
URL object is first 
created. Also see the 
definition for 
ENABLEPROXY (page 174). 



This sets the default 
value for ENABLESOCKS 
for all URL objects. 
The "Socks server" 
check box on the Server 
page of a URL's 
properties notebook is 
checked when the 
Default push button is 
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WPUrl 

Key Name Value Description [V4i 



DEFAULTINTEGRATEDBROWSER 
NO | YES 



DEFAULTLOADGRAPHICS 

YES | NO 



DEFAULTNEWSSERVER 



pressed or when the URL 
object is first 
created. Also see the 
definition for 
ENABLESOCKS (page 174). 



This sets the default 
value for 

INTEGRATEDBROWSER for 
all URL objects. The 
"Integrated browser" 
check box on the 
Browser page of a URL's 
properties notebook is 
checked when the 
Default push button is 
pressed or when the URL 
object is first 
created. Also see the 
definition for 
INTEGRATEDBROWSER (page 
174). 



This sets the default 
value for LOADGRAPHICS 
for all URL objects. 
The "Load graphics" 
check box on the 
Browser page of a URL's 
properties notebook is 
checked when the 
Default push button is 
pressed or when the URL 
object is first 
created. Also see the 
definition for 
LOADGRAPHICS (page 
175). 
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WPUrl 

Key Name Value Description (V4) 



newsserver This sets the default 

value for NEWSERVER for 
all URL objects. This 
value will be placed in 
the "Newsserver" field 
on the Server page of a 
URL's properties 
notebook when the 
Default push button is 
pressed and when the 
URL object is first 
created. Also see the 
definition for 
NEWSERVER (page 176). 

DEFAULTPALETTEAWARE 

NO | YES This sets the default 
value for PALETTEAWARE 
for all URL objects. 
The "Palette aware" 
check box on the Web 
page of a URL's 
properties notebook is 
checked when the 
Default push button is 
pressed or when the URL 
object is first 
created. Also see the 
definition for 
PALETTEAWARE (page 
176). 

DEFAULTPARAMETERS 

parameters This sets the default 
value for PARAMETERS 
for all URL objects. 
This value will be 
placed in the 
"Parameters" field on 
the Browser page of a 
URL's properties 
notebook when the 
Default push button is 
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WPUrl 

Key Name Value Description (V4) 



DEFAULTPRESENTATIONMODE 
NO | YES 



DEFAULTPROXYGATEWAY 
proxy 




DEFAULTSOCKSSERVER 



pressed and when the 
URL object is first 
created. Also see the 
definition for 
PARAMETERS (page 177). 



This sets the default 
value for 

PRESENTATIONMODE for 
all URL objects. The 
"Presentation mode" 
check box on the Web 
page of a URL's 
properties notebook is 
checked when the 
Default push button is 
pressed or when the URL 
object is first 
created. Also see the 
definition for 
PRESENTATIONMODE (page 
177). 

This sets the default 
value for PROXYGATEWAY 
for all URL objects. 
This value will be 
placed in the "Proxy 
gatewway" field on the 
Server page of a URL's 
properties notebook 
when the Default push 
button is pressed and 
when the URL object is 
first created. Also see 
the definition for 
PROXYGATEWAY (page 
177). 
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WPUH 

Key Name Value Description (V4) 



socks This sets the default 

value for SOCKSERVER 
for all URL objects. 
This value wil 1 be 
placed in the "Socks 
server" field on the 
Server page of a URL's 
properties notebook 
when the Default push 
button is pressed and 
when the URL object is 
first created. Also see 
the definition for 
SOCKSERVER (page 178). 

DEFAULTWORKINGDIR 

directory This sets the default 
value for WORKINGDIR 
for all URL objects. 
This value will be 
placed in the "Working 
directory" field on the 
Server page of a URL's 
properties notebook 
when the Default push 
button is pressed and 
when the URL object is 
first created. Also see 
the definition for 
WORKINGDIR (page 179). 

DISPLAYIMAGES YES | NO Specifies that the 

browser show the images 
as they are being 
constructed on the page 
while being received 
from the server. This 
is the default value 
for the "Display images 
while loading" check 
box on the Web page. 
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Key Name Value Description [V4l 



EMAILADDRESS address This is a required 

field. It specifies the 
user's return E-mail 
address to be used by 
the browser when 
responding to other 
users on mail -to fields 
of web pages or 
newsgroup articles. 
This should be the 
complete internet E- 
mail address. For 
example: 

dgoran@cf srexx.com 

Leaving this field 
blank will prevent you 
from responding to 
mail -to fields and 
newsgroup articles. 

This sets the "Enable 
proxy?" check box on 
the Server page of a 
URL's properties 
notebook. If the 
"Enable proxy?" check 
box is not checked, the 
proxy server will not 
be used. 

ENABLESOCKS 

NO | YES This sets the "Socks 
server" check box on 
the Server page of a 
URL's properties 
notebook. If the 
"Socks server" check 
box is not checked, the 
Socks server wil 1 not 
be used. 

INTEGRATEDBROWSER 



ENABLEPROXY NO | YES 
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WPUrl 
Key Name 

YES 



NO 



LOADGRAPHICS YES | NO 



This sets the default 
value for BROWSER for 
all URL objects. If the 
"Integrated browser" 
check box on the 
Browser page is 
checked, this specified 
that the designated 
executable has been 
integrated with the URL 
object. For example, 
the IBM WebExplorer 
browser has been 
integrated, you would 
specify YES if you are 
using EXPLORE. EXE. The 
Java Applet viewer is 
not integrated if you 
are using APPLET. EXE. 
Other browsers might 
not be integrated with 
the URL object. Check 
the documentation 
provided with your 
browser. 

If the "Integrated 
browser" check box is 
not checked, you will 
be unable to use 
certain browser 
parameters (for 
example, Palette Aware, 
Presentation Mode, and 
Load Graphi cs) because 
a non-integrated 
browser cannot 
interpret these command 
line arguments. 

Specifies that you can 
load graphics and 
images on the web page 
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Key Name Value Description (V4) 



specified by the URL if 
the "Load graphics" 
check box on the Web 
page is checked; 
otherwise, just text 
will be loaded which 
will speed up page 
downloads. 

LOCATOR url Specifies the Uniform 

Resource Locator that 
uniquely identifies 
each web page 
designated in the 
"Uniform Resource 
Locator (URL)" field on 
the Web page. The URL 
is the address for the 
page on the web. For 
example: 

http://www.cfsrexx.com 

Note: The keywords LOCATOR and URL can be 

used interchangeably. 

NEWSERVER news Specifies the l^ost name 

or IP address of the 
server that handles 
newsgroups for the 
^user's company or 
account. The first 
example is a host name 
^^and the second example 
is an IP address: 
news.company.com or 
128.35.89.2 

PALETTEAWARE YES | NO Specifies the default 

value for BROWSER for 
all URL objects. This 
value will be placed in 
the "Paletteaware" 
check box on the Web 
page. Specifies that 
the OS/2 palette be 
used to display pages 
and images. 
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Kev Name Value Description (V4) 



PARAMETERS params 



PRESENTATIONMODE 

NO | YES 



PROXYGATEWAY proxy 



Specifies strings to be 
included on the command 
line invocation of the 
designated executable 
when it is started. If 
the browser being used 
permits optional 
parameters, declare 
them using this value. 
This sets the default 
value for BROWSER for 
all URL objects. This 
value will be placed in 
the "Parameters" field 
on the Browser page. 



Specifies that the 
browser use the full- 
screen (non-windowed) 
mode. This mode is 
generally used for 
presentations. This 
value is used for the 
"Presentation mode" 
check box on the Web 
page. This is the 
default value, which 
specifies that the 
executable use the OS/2 
palette to display its 
pages and images. 

Specifies the URL of 
the server that handles 
the interface to the 
web for the user's 
company or account. It 
is the f i re wal 1 for 
insulation of a company 
from the outside world. 
A proxy port can also 
be appended to the end 
of the proxy string if 
the proxy server 
supports it. For 
example: 

http://proxy.company.co 
m/or 

http://128.35. 89. 2/ 

A proxy port can also 
be appended to the end 
of the proxy string if 



©1993-1997 by C F S Nevada, Inc. 



177 



Rev 4.0 



WPUrl 

Key Name Value Description (V4) 



the proxy server 
supports it. For 
example: 

http : //proxy . company . co 
m:80/ 

This value will be 
placed in the "Proxy 
gateway" field on the 
Server page. The slash 
on the end is required 
syntax. Contact your 
system administrator 
for details about using 
a proxy gateway server 
on your system. 

SOCKSERVER socks Specifies the socks 

support that wi 1 1 
provide access the web 
through a fire wal 1 , 
which provides for 
insulation of a company 
from the outside world. 
This value is placed in 
the "Socks server" 
field on the Server 
page. For example: 
http://socks.company.co 
m/ or 

httpj /socks . company . com 
:807 



The jA ash on the end is 
uired syntax. 

) 

URL url Specifies the Uniform 

Resource Locator that 
uniquely identifies 
each web page 
designated in the 
"Uniform Resource 
Locator (URL)" field on 
the web page. The URL 
is the address for a 
page on the web. For 
example, an URL might 
be: 

http : //www. cf srexx . com 

Note: Tlie keywords URL and LOCATOR can be 

used interchangeably. 
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Key Name Val ue Description [¥4]. 



WORKINGDIR directory Specifies OS/2 working 

directory for the 
executable, if 
required, and sets the 
default value for 
BROWSER for all URL 
objects. This value 
will be placed in the 
"Working directory" 
field on the Browser 
page. A working 
directory is required 
if the specified 
browser requires DLLs 
or other files from a 
directory not specified 
in the LIBPATH or other 
environment variables. 

4.6 DOS / WIN-OS/2 Settings 

The DOS and WIN-OS/2 Settings are located within the 
Session tab of a WPProgram object. They are grouped here 
separately since there are special considerations used in their 
"key name = value" format. 

These values are specified with SET key name = value. For 
example: 

SET DOS_FILES=45;SET D0S_HIGH=1; 

When the value is alphabetic, it appears that it is case 
sensitive. For example: 

SET DPMI_DOS_API=disabted 
will not affect the VDM's value; however, 

SET DPMI_DOS_API=DISABLED 

does result in the VDM's setting being changed. 

In almost all instances, where the value is shown as either ON 
or OFF, the actual value used in the SET statement is 1 for 
ON and 0 for OFF. For example: 

SET C0M_H0LD=1; (on, default is off) 
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To specify more than one DOS_DEVICE file name, each 
must be separated with a comma. For example: 

'...;SET D0S_DEVICE=C:\0S2\MD0S\ANSI.SYS, - 

- C:\0S2\MD0S\EGA.SYS...;' 

For those key names which do not show a value here, check 
the DOS Settings tab in the Program tab of the settings 
notebook of any DOS VDM. 

Where possible, any default value is shown as an underlined 
value; however, defaults can vary on a system-by-system basis 
because of different hardware configurations, installation 
selected options and software dependent considerations. The 
initial values for any given system can be found in 
? :\OS2\INST ALIADBT AGS .D AT on that system. 

Beginning with Warp Version 3.0, an encoded version of the 
settings for any DOS or WIN-OS2 object can be printed or 
written to an "encoded" file. If the file output option is 
selected, any file and path name may be specified; however, 
the default path shown will be the path of the spool file. This 
encoded file may then be imported into any other DOS or 
WIN-OS2 object. With^care, it is possible to alter these 
parameter values with an ASCII editor before loading them 
then into the object's settings. 

It appears that these encoded files are composed of a two line 
header followed by a repeating group of 4 lines per setting 
and a blank line. The table below shows the apparent format 
of these lines: 

s=DCF 

i=title of object 

p=parameter key word 

t=type of field for value (0-5) 

v=parameter value (may be followed by comment) 

d=default value (may be followed by comment) 

Beginning with Warp Version 4, each of the key name = value 
pairs may be specified as DosSetting. concatenated with the 
key word = value pair as an environment variable within an 
OS/2 session (windowed or full screen). Each DOS VDM 
started with the START command will reflect these settings. 
For example: 

SET DosSet t i ng . dos_background_execut i on=0 
SET DosSetting.dos_f iles=90 
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start /dos /win 

Key names associated only with Windows sessions (WIN-OS/2) 
are included at the end of this section. 

DOS Settings 

Key Name Val ue Description 

AU D 1 0_AD A PTE R_S H AR I NG 
None 



Indicates that a pro- 
gram in this DOS ses- 
sion does not require 
an audio adapter. 



Optional Indicates that a pro- 
gram in this DOS ses- 
sion should use an au- 
dio adapter if one is 
available. 

Required Indicates that a pro- 
gram in this DOS ses- 
sion must have access 
to an audio adapter. 

Note: Case must be os shown. 



COMJ)IRECT_ACCESS 

0|1 

COMJOLD 0 | 1 



Allow direct access to 
the COM ports. 

When set on, provides 
exclusive access to COM 
ports for the specified 
VDM, preventing other 
processes from using 
the port and preventing 
the operating system 
from releasing the port 
until the VDM ter- 
minates. 
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DOS Settings 

Key Name Value 



Description 



Indicates that, for 
this DOS session, the 
operating system is to 
keep data in the 
received data buffer. 

RECEIVE DATA INTERRUPT ENABLE 
Any data in the 
received data buffer 
for this DOS session 
will be discarded 
whenever the DOS 
program enables the 
received data 
interrupt. 

SWITCH TO FOREGROUND 

Any data in the 
received data buffer 
for this DOS session 
will be discarded 
whenever the DOS 
program is brought to 
the foreground (from a 
background state). 

ALL Indicates that communi- 

cations data be dis- 
carded when a DOS pro- 
gram enables the 
received data interrupt 
or the program is 
switched to the fore- 
ground. When ALL set, 
both the "RECEIVE DATA 
INTERRUPT ENABLED" and 
the "SWITCH TO 
FOREGROUND" options are 
enabled. 



COMJECEIVE__BUFFERJLUSH 
NONE 
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DOS Settings 

Kev Name Value Description 



COM SELECT 



ALL 

NONE 

COMn 



When set to COMn (where 
n is a value of 1 to 
4), the program will be 
allowed to select and 
use only the COMn 
communication port. 



Note: All the above settings, beginning 

with COM, are removed when the SIO 
I VSIO drivers from Ray Gwinn are 
implemented (noted below in 
connection with the SIO_ settings). 

D0S_AUT0EXEC T:\AUTOEXEC.BAT 

Used to specify a dif- 
ferent batch file other 
than the default. 



D0S_BACKGR0UND_EXECUTI0N 
1 | 0 



Allows or disallows 
execution of the 
program when it is in 
the background. 



D0S_BREAK 0 | 1 



DOS DEVICE file name 



Disables or enables 
Ctrl+Break for the spe- 
cified VDM. 

Indicates that 
file_name should be 
added to the VDM as a 
device driver. Multiple 
file names are 
separated with a comma. 



Note 01: If any device drivers are specified, 
then all device drivers for that 
object MUST be specified since 
previous values are deleted 
regardless of whether specified via 
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DOS Settings 

Key Name Val ue Description 



SysCreateObjectf) or 
SysSetObjectDataO . 

Note 02: The default device driver list is 
taken from CONFIG.SYS. If a 
customized list of device drivers is 
specified for an object, the device 
drivers specified in CONFIG.SYS are 
ignored. 



DOS FGBS 16 




DOS FCBS KEEP 8 



DOS FILES 20 



DOSJIGH 0 | 1 



Specifies the maximum 
number of file control 
blocks (FCBs) which can 
be opened by applica- 
tions running in the 
VDM. Value can range 
from 0 to 255. 

Specifies the number of 
file control blocks 
FCBs that will be pro- 
tected against automat- 
ic closure. Value can 
range from 0 to 255. 

Specifies the maximum 
number of file handles 
which can be opened in 
a VDM. Default is 
replaced by FILES* 
value from CONFIG.SYS. 
Value can range from 20 
to 255. 

Determines whether DOS 
is loaded above the 
640KB low memory ad- 
dress space. 
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Key Name Value 



Description 



DOS LASTDRIVE Z 



Specifies the highest 
available logical drive 
letter for the speci- 
fied VDM. 



DOS RMSIZE 



640 



Specifies the DOS memo- 
ry size in kilobytes 
(KB). This is the 
amount of memory which 
is available to DOS 
applications. Value can 
range from 128 to 640 
in increments of 16. 



D0S_SHELL ?:\0S2\MD0S\C0MMAND.C0M ?:\0S2\MD0S /P 

May be used to specify 
the DOS command 
processor, or to add 
parameters to affect 
the command processor. 
? represents the boot 
drive. 

Note: Default is SHELL* value from 

CONFIG.SYS: 



DOS_STARTUP_DRIVE 

blank 



Specifies the location 
of the DOS kernel to be 
loaded into the VDM. 



DOSJJMB 0 | 1 Specifies whether DOS 

owns Upper Memory 
Blocks (UMBs) and man- 
ages the loading of 
device drivers and TSR 
programs. 
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D0S_VERSI0N programjiame* , major* ,mi nor * .count 

Allows the operating 
system to report a 
"fake" DOS version num- 
ber (major - version, 
minor - modification 
level, count - number 
of times to return this 
level) in order to 
support applications 
A, which check for a DOS 

J version number. 

Note 01: A he comma between the values is 

escaped with the caret ( A - '5E'x). 

Note 02: Initially set to the values 
specified in 

?: \0S2\INSTALL\DBTAGS.DAT 

DPMI_DOS_API AUTO | ENABLED | DISABLED 

Determines whether DOS 
API "translation is en- 
abled for the specified 
VDM. 



DPMI_MEMORY_LIMIT 
4 



Specifies the maximum 
amount of protected 
mode memory (in mega- 
bytes) available to 
DPMI applications run- 
ning in the VDM. Value 
can range from 0 to 
512. 
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Kev Name Value Description 



DPMI_NETWORK_BUFF_SIZE 
8 



EMS_FRAME_L0CATI0N 

AUTO | NONE 

8000 I 8400 

C000 | C400 

D0O0 | D400 



EMS_HIGH_0S_MAP_REGI0N 
32 



Note: 



EMS_L0W_0S_MAP_REGI0N 
384 



Specifies the size, in 
kilobytes (KB), of the 
network translation 
buffer for DPMI pro- 
grams in this session. 
Value can range from 1 
to 64. 



j 8800 | 8C00 | 9000 

| C800 | CCOO j 

j D800 | DCOO j 
Allows the location of 
the LIM EMS region to 
be explicitly changed. 



Provides the capability 
of adjusting the size 
of an additional EMS 
region in KB. Value can 
range from 0 to 96 in 
increments of 16. 



Set the size, in KB, of 
the remappable 
conventional memory 
available in a VDM. 
Value can range from 0 
to 576 in increments of 
16. 



Though the available documentation 
indicates that the default value for 
this setting is 32, testing yielded 
a default value of 0. 
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Key Name Val ue Description 



EMS_MEMORY_LIMIT 

2048 



HWJMSOUND 0 | 1 



HW_ROM_TO_RAM 0 | 1 



HWJIMER 0 | 1 



IDLEJECONDS 0 



Set the amount of EMS 
memory, in KB, 
available to a VDM. 
Value can range from 0 
to 32768 in increments 
of 16. 

Allows or disallows 
sounds started by a DOS 
program. 

xEnabling causes the 
operating system to 
copy read-only memory 
(ROM) and run the copy 
in 32-bit random access 
memory (RAM). 

Allows an application 
to have direct access 
to the timer ports and 
prevents the operating 
system from trapping, 
or intercepting, the 
timer request and 
emulating a timer. 

Disables the 
"IDLEJENSITIVITY" fun- 
ction for a period of 
time after useful work 
has been detected. 
Value can range from 0 
to 60. 
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Key Name Val ue Description 



IDLE_SENSITIVITY 

75 



INT_DURING_IO 0 | 1 



KBD_ALTHOME_BYPASS 

0 | 1 



KBD_BUFFER_EXTEND 

1 | 0 



KBD_CTRL_BYPASS NONE 

ALTJSC 
CTRLJSC 



The value is the per- 
centage of the maximum 
possible polling rate 
the application can 
perform. If an applica- 
tion polls at a rate 
higher than this value, 
it is considered 
"idle." Value can range 
from 1 to 100. 

When set on, this cre- 
ates a second thread 
for the application to 
use for interrupt han- 
dling when the primary 
thread is busy with I/O 
operations. 



When enabled, prevents 
the Alt+Home key 
sequence from switching 
the VDM between full 
screen and windowed 
mode. 



Increases a VDM l s 
keyboard type-ahead 
buffer size. 



When enabled, inhibits 
one of the control key 
sequences, allowing an 
application in the VDM 
to use this sequence 
for its own purposes. 
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Key Name Value Description 



KBD_RATE_LOCK 0 | 1 



Prevents a DOS 
application in a VDM 
from changing the 
system keyboard repeat 
rate. 



MEM_EXCLUDEJREGIONS 
MEM_INCLUDE_REGIONS 
blank 



MOUSE EXCLUSIVEJ^eetSS 
2 I 1 




These settings are used 
tq specify address 
ranges which should be 
protected / included 
from use by EMS/XMS and 
direct access by appli- 
cations. 



This setting allows 
VDMs to run ap- 
plications which main- 
tain their own mouse 
pointers. 



NETWARE_RESOURCES 

GLOBAL 

PRIVATE 

NONE 



Created by the Netware 
requester's VSHELL.SYS 
virtual device driver. 
It determines whether a 
DOS session uses the 
virtual Netware shell 
services (GLOBAL), or 
must use an explicit 
load of NETX to get 
shell services 
(PRIVATE). 



Note: There apparently is a bug in OS/2 

2.1 GA which requires that this 
field be padded on the right with 
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Kev Name Value Description 



spaces for a total field length of 7 
(e.g. LEFT( 'NONE', 7 ). 



PRINT_SEPARATE_OUTPUT 
I I 0 



The default value for 
this setting is On, 
which separates the 
printer output for each 
DOS program that is 
running in the same DOS 
session. 



PRINT TIMEOUT 15 



Use this setting to 
adjust the amount of 
time, in seconds, that 
the OS/2 V2.X print 
subsystem waits before 
forcing a print job to 
the printer. Value can 
range from 0 to 3600. 



SESSI0N_PRI0RITY 

1 



(V3) 

This setting can be 
used to change the 
session's priority from 
1 (lowest priority) to 
32 (highest priority) 
for the DOS or WIN-0S2 
session. 



Each of the following key name-pair values, which begins with 
SIO_, are considered to be private and are both set and used 
by the SIO / VSIO drivers developed by Ray Gwinn. Refer td 
the documentation which accompanies these drivers for an 
explanation of their function. 



SI0_Allow Access_C0Mn 

SIO_IdleJ>ensitivity 

SIO Mode_DataBits 

SI0_Mode_DTR 

SIO Mode_FIFOJ_oad_Count 

SI0_ModeJDSR 

SI0_Mode_0CTS 

SIO Mode ODSR 



SIO_Mode_RTS 
SIO Mode_StopBits 
SI0_Mode_X0N/X0FF 
SIO_Screen_Sync_Kludge 
SIO Share_Access_With_0S/2 
SIO_Virtual_DTR_i s_HS 
SIO Virtual_RTS_is HS 
SIO Virtual ize 16550A 
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SIO_Mode_Parity 

TOUCH EXCLUSIVE ACCESS 
~0 | 1 



VIDEO 8514A XGA IOTRAP^ 
~ *i I 0 



VIDEO_FASTPASTE 0 | 1 



VIDEO_MODE_RESTRICTION 
none 
CGA 
MONO 



Note: 



VIDEO ONDEMAND MEMORY 

: I I 0 



VIDEO RETRACE EMULATION 
" 1 | 0 



Description 



SIO_Virtualize_COM_Ports 



Set ON to give the 
windowed DOS program 
exclusive ownership of 
the touch display. Only 
the DOS application 
will receive touch 
display data, not PM. 
Mouse emulation in PM 
is turned off. 



When set OFF, un- 
restricted access to 
the 8514/A display 
adapter hardware is 
allowed. (Only avail- 
able for systems with 
8514/A or XGA display 
adapters installed.) 

Speeds up input from 
other sources than the 
keyboard. 



Extends the 640KB DOS 
address space by limit- 
ing video mode support. 



Reduces swap space re 
quirements for full- 
screen VDMs. 



Simulates the video 
retrace status port to 
provide faster access. 



There is a bug in OS/2 2.1 6A which 
requires that this field be podded 
on the right with spaces for a total 
field length of 15 (e.g LEFT( 'CGA', 

15 
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Description 



VIDEO ROM EMULATION 



VIDEO SWITCH NOTIFICATION 
" 0 | 1 



VIDEO WINDOW REFRESH 
0.1 



XMS HANDLES 32 



XMS MEMORY_LIMIT 

2048 



XMS_MINIMUM_HMA 0 



Windows sessions only: 
WIN ATM 

0 | 1 



WIN_CLIPBOARD 1 | 0 



Emulates selected INT 
lOh ROM Video func- 
tions. 



Notifies a DOS applica- 
tion of a switch to / 
from full -screen mode. 
Default is ON for Win- 
OS/2 sessions. 



Adjusts the window up- 
date frequency for a 
given VDM (tenths of a 
second) . Value can 
range from 0.1 to 60 (1 
minute) . 

Specifies the number of 
XMS extended memory 
block (EMB) handles. 
Value can range from 0 
to 128. 



Specifies the amount of 
XMS memory, in KB, for 
this VDM. Value can 
range from 0 to 16384 
in increments of 4. 

Specifies the minimum 
HMA memory request al- 
lowed in KB. Value can 
range from 0 to 63. 



(V3) 

Disables or enables 
Adobe Type Manager font 
support for Win-0S2 
programs. 

When set on, this will 
allow the session to 
share clipboard infor- 
mation among OS/2, DOS 
(window), and Windows 
programs. 
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Key Name Value Description 



WIN_DDE 1 | 0 When set on, this will 

enable sharing of data 
among other OS/2 and 
Windows programs. 

WIN RUN MODE See PROGTYPE settings 

~ " under the SESSION tab 

in the WPProgram 
settings on page 164. 

Note: Windowed vs. full screen windowed 
sessions are governed by EXENAME 
(page 161) of the program object 
being set to PROGMAN.EXE or not. 
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5. WPTools 

The WPTools API is unique freeware that was developed by 
Henk Kelder of the Netherlands and is used within his 
CHECKINI program. CHECKINI is a utility which can be 
used to maintain OS/2 INI files. WPTools may be downloaded 
via anonymous FTP from ftp.cfsrexx.comlpub/wptool*.zip or 
with a World Wide Web browser at www.cfsrexx.com on the 
REXX-related files page. 

WPTOOLS.DLL is a Dynamic Link Library that contains two 
extremely useful and unique functions which provide an 
interface between REXX programs and Workplace Shell 
objects. Though WPTOOLS.DLL contains only two functions 
in addition to its registration entry point, those functions are 
generally unavailable elsewhere. 

REXX must be informed of WPTools' presence and, once 
registered, each WPTools function is available to all other 
REXX sessions. WPTools can be registered with: 

call RxFuncAdd 'WPToolsLoadFuncs, -* 

- 'WPTOOLS', 'WPToolsLoadFuncs' 

call WPToolsLoadFuncs 

WPToolsQueryObject has code to support (almost) all object 
classes for which object setup strings are defined, being: 

Class Setup strings returned 

WPObject CCVIEW, DEFAULT VIEW, HELPPANEL, 

HIDEBUTTON, MINWIN, NOCOPY, NODELETE, 
NODRAG, NODROP, NOLINK, NOMOVE, 
NOPRINT, NORENAME, NOSETTINGS, 
NOSHADOW, NOTVISIBLE, OBJECTID, TITLE 

WPAbstract TEMPLATE 

WPProgram ASSOCFILTER, ASSOCTYPE, EXENAME, 

MAXIMIZED, MINIMIZED, NOAUTOCLOSE, 
PARAMETERS, PROGTYPE, SET, STARTUPDIR 

WPShadow SHADOWID 

WPRPrinter NETID (1) 

WPPrint APPDEFAULT, JOBDIALOGBEFOREPRINT, 

OUTPUTTOFILE, PORTNAME, PRINTDRIVER, 
PRINTERSPECIFICFORMAT, 
PRINTWHILESPOOLING, QSTARTTIME, 
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QSTOPTIME, QUEUENAME, QUEUEDRIVER, 

SEPARATORFILE 
WPServer NETID (2) 

WPNetgrp NETID (2) 

WPDisk ORIVENUM 

WPFontPalette FONTS, XCELLCOUNT, YCELLCOUNT, 

XCELLWIDTH, XCELLHEIGHT, XCELLGAP, 
YCELLGAP 

WPColorPalette COLORS, XCELLCOUNT, YCELLCOUNT, 

XCELLWIDTH, XCELLHEIGHT, XCELLGAP, 
YCELLGAP 

WPFileSystem MENU (3) 

WPProgramFile ASSOCFILTER, ASSOCTYPE, EXENAME, 

MAXIMIZED, MINIMIZED, NOAUTOCLOSE, 
PARAMETERS, PROGTYPE, SET, STARTUPDIR 

WPFolder ALWAYSSORT, BACKGROUND, DETAILSCLASS, 

DETAILSFONTS, ICONFONT, TREEFONT, 
ICONNFILE, ICONVIEW, SORTCLASS, 
TREEVIEW, DETAILSVIEW, WORKAREA 

WPLaunchPad All documented setup strings. 



(1) Includes settings for WPPrint. 

(2) These settings cannot be used to 
recreate the object. 

(3) MENU doesn't work when applying* 



For each object, WPToolsQueryObjectQ returns not 
only setup string values for the object itself (when 
supported), but also for all parent classes. When, 
for example, one uses WPToolsQueryObjectQ against 
the Desktop (class WPDesktop) setup strings will be 
returned from the classes WPFolder, WPFileSystem and 
WPObject. 
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5 . 1 WPTools Functions 

WPToolsFolderContent( folder, stem ) 

Returns 1 indicating that the identity of all of the 
abstract objects contained in folder have been 
sequentially assigned to the tails of stem; otherwise, 
returns 0. 

Folder is either the object ID or the full file system name 
of the folder / directory to be interrogated. 

On successful completion, stem.O will contain the number 
of abstract objects identified. Each entry returned will be 
either the object ID or a string beginning with the 
character # followed by the character string notation of 
the object's handle. (Handles are the internal 
identification assigned to every object in the WPS.) 

WPToolsQueryObject( object, [class], [title], - 

- [setup] , [location] ) 

Returns 1 indicating that the specified properties of 
object were retrieved; otherwise, returns 0. 

Class, title, setup, and location are optional variable 
names that will have the respective properties assigned 
to them. As such, they should be surrounded with quotes 
to prevent a NO VALUE condition. 

Object may contain a full file system name or a string 
containing the # character followed by the character 
representation of the object's handle (see 
WPToolsFolderContent(), page 197, for a description of 
handles). 

Class, if specified, will contain the Workplace Shell class 
of the object. Title, if specified, will contain the object's 
title. Setup, if specified, will contain the setup string 
which can be used to recreate the object. The setup 
string will contain the parameters that could be used 
with SysCreateObject() or SysSetObjectData() to create 
/ modify the object. Location, if specified, will contain 
the object's location. 
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WPToolsVersion() 

Returns the version and modification level o 
WPTOOLS.DLL as two numbers separated by a period 
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6. RxFTP - REXX File Transfer 
Protocol 

The RxFTP API (RXFTP.DLL) provides the facility for a 
REXX program to utilize the TCP/IP FTP protocol from 
within a REXX program. Information on the FTP 
subcommands is contained in the IBM Transmission Control 
Protocol/Internet Protocol Version 4 for OS/2: User's Guide 
(Warp Version 4 - \tcpip\help\tcpguifde/hlp). 

Information on FTP API calls is contained in the IBM 
Transmission Control Protocol /Internet Protocol Version 4 for 
OS/2: Programmers Reference (Warp Version 4 
\tcpip\help\tcpcr .hip) . 

Most of the REXX FTP API functions correspond to their 
like-named FTP subcommands. 

Opening and Closing Functions: 

FtpDropFuncs () FtpLoadFuncs () FtpLogoff () 
FtpSetBinaryQ FtpSetUserQ FtpVersionQ 



File Action Functions: 
FtpAppend() 
FtpPutQ 



FtpDelete() 
FtpPutUrriqueQ 



FtpGetQ 
FtpRenameQ 



Directory Listing Functions: 

FtpDirf) FtpLsf) 

Directory Action Functions: 

FtpChDir() FtpMkDir() 
FtpRmDirQ 

Remote Server Functions: 

FtpPingO FtpProxy() 
FtpSiteQ FtpSysO 



FtpPwd() 



FtpQuote() 



RxFTP must be loaded and REXX must be informed of its 
presence. This task is accomplished in a similar fashion to 
REXXUTIL and, once registered, each function is available 
to all other REXX sessions. RxFTP can be registered with: 
call RxFuncAdd 'FtpLoadFuncs', -» 

-» 'RXFTP' , 'FtpLoadFuncs' 

call FtpLoadFuncs 
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It can be removed (unregistered) with: 
call FtpDropFuncs 

6.1 RxFTP Return Values 



RxFTP return values are divided between "Set errors" anc 
"FTP Errors". Set errors result from the FtpSetBinaryO anc 
FtpSetUserO functions. All other functions return FTP error: 
in the variable FTPERRNO if necessary. 

Set Error Values 



The Set error codes are returned by functions that pass string 
to RxFTP that, in turn, are used by subsequent calls to RxFT] 
functions. The Set error codes returned are 1 if a valid strin 
is passed to the function and 0 if an invalid string is passed t« 
the function. 



FTP Error Values 



All of the RxFTP functions which result in communicatio 
between the local program and a remote host return 0 for 
successful call and -1 if there is an error associated with th 
RxFTP function call. If -1 is returned by any RxFTP functic 
call except for FtpPingO, the predefined variable FTPERRN< 
will contain one of the following strings: 



FTPABORT 
FTPCOMMAND 
FTPCONNECT 
FTPDATACONN 

FTPHOST 
FTPLbCALFILE 
FTPLOGIN 
FTPN(j>PRIMARY 

FTPNOXLATETTBL 

FTPPROXYTHIRD 

FTPSERVICE 
FTPSOCKET 



Transfer stopped 
Command failed 
Unable to connect to server 
Error initializing data 
connection 
Unknown host 

Error opening local file 
Login failed 

No primary connection for pro) 
transfer 

No code page translation tabl< 
was loaded 

Proxy server does not support 
third party transfers 
Unknown service 
Unable to obtain socket 



Note: FtpPingO return values are unique and c 
described along with the function. 
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6.2 RxFTP Functions 

FtpAppend( local file, remote_file[, - 

- BINARY | ASCII] ) 

Returns 0 after successfully initiating a copy of local Jile 
to a remote host and adding local Jile to the end of an 
existing file of the same name on the remote host; 
otherwise, returns -1 and assigns a value to the 
predefined variable FTPERRNO. 

As an option, you can specify the transfer to occur in 
binary mode or text (ASCII) mode. If a you do not 
specify the transfer mode with this call, the mode 
specified with a previous FtpSetBinaryO call is used. 

The remote host is specified with a previous 
FtpSetUserO function call. Local Jile specifies the name 
of the file on the client. Remote Jile is the name of the 
file as it is known on the remote host. Case sensitivity is 
determined by the remote host. 

FtpChDir( directoryjiame ) 

Returns 0 after successfully changing the working 
directory on the remote host to directory jwme; 
otherwise, returns -1 and assigns a value to the 
predefined variable FTPERRNO. The remote host is 
specified with a previous FtpSetUserO function call. 

FtpDelete( filejiame ) 

Returns 0 after successfully deleting filejiame on the 
remote host; otherwise, returns -1 and assigns a value to 
the predefined variable FTPERRNO. The remote host 
is specified with a previous FtpSetUserO function call. 

FtpDir( pattern, 'stem.' ) 

Returns 0 after successfully retrieving the long format of 
the directory information of the working directory on the 
remote host; otherwise, returns -1 and assigns a value to 
the predefined variable FTPERRNO. The remote host 
is specified with a previous FtpSetUserO function call. 
Similar in function to FtpLs() which retrieves a short 
format of the directory information. 
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Pattern is an editing pattern composed of file name 
wildcard characters ? and *. 

Note 01: The stem parameter value must include the 
trailing period and the name must be contained 
within quotes. 

Note 02: Since the position of the values returned for each 
directory line may vary for Unix-style servers by 
the host file system, care must be used in parsing 
the field values. The following is a suggested 
technique that should be valid on most Unix-style 
file servers: 
select 

when WORDS( directoryjine ) = 1 then 
do 

/* next level directory name */ 

end 

when WORDSC di rectory_l ine ) = 2 then 
do 

/* total nnn line */ 

end 
otherwise 
do 

parse value di rectory_l ine with, 

01 directory_indic, 

02 owner_rwx f 
05 group_rwx, 

08 world_rwx +3, 
directoryjdepth, 
owner_id, 
group_Jd, 
file_size, 
month, 
day, 

time_or_year, 
f i le_name 
filejiame = STRIP( file_name ) 
parse value file_name with, 
file name, 
' ">"', 

redi rected_path_and_f i I e_name 

end 

end 

FtpDropFuncs() 

Returns a null string after removing the definitions of all 
RxFTP functions from the operating system. 
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FtpGet( "local_file, remote_file[, mode ] ) 

Returns 0 after successfully coping remote Jile on the 
remote host to the path and name specified in local Jile; 
otherwise, returns -1 and assigns a value to the 
predefined variable FTPERRNO. The remote host is 
specified with a previous FtpSetUser() function call. 

Mode is either ASCII or BINARY (or an abbreviation 
of either) and specifies the mode for the file transfer. If 
mode is omitted, a previous call to FtpSetBinaryO 
determines the mode of transfer. 

Both local Jile and remote Jile can contain path directives 
which will be taken as relative to the current respective 
directory. Local Jile can optionally contain a drive 
designation. 

Note: It appears that the default transfer mode is 
binary; however, it is recommended that a mode 
be specified explicitly. 

Ftp Load Fun cs( parameter ) 

Returns a null string after registering all of the functions 
in RXFTP.DLL. The presence of any value, including a 
null string, as a parameter will inhibit the copyright 
notice from being displayed when the functions are 
registered. 

FtpLogoff() 

Returns 0 after ending all FTP sessions with the host, 
user ID, and account established by FtpSetUser(). 
Repeated calls to this function will always return 0, even 
if no session is established. 

FtpLs( pattern, 'stem.' ) 

Returns 0 after successfully retrieving the short format 
of the directory information of the working directory on 
the remote host; otherwise, returns -1 and assigns a 
value to the predefined variable FTPERRNO. The 
remote host is specified with a previous FtpSetUser() 
function call. Similar in function to FtpDir() which 
retrieves a long format of the directory information. 

Pattern is an editing pattern composed of file name 
wildcard characters ? and *. 
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Note 01: Tlie stem parameter value must include the 
trailing period and the name must be contained 
within quotes. 

FtpMkDir( directory ) 

Returns 0 after successfully creating directory on the 
remote host; otherwise, returns -1 and assigns a value to 
the predefined variable FTPERRNO. The remote host 
is specified with a previous FtpSetUserQ function call 

"^Returns information resulting from sending a ping to the 
remote host. The remote host is specified with a 
previous FtpSetUser() function call. This function tries 
to resolve the host name through a name server. It a 
name server is not present, FtpPingO searches the 
TCPIP\ETC\HOSTS file for a matching host name. 
Returned information can be: 

milliseconds The number of milliseconds it took 

for the echo to successfully return. 
PINGHOST Unknown host 
PINGPROTO Unknown protocol ICMP 
PINGRECV Receive failed 
PINGREPLY Host does not reply 
PINGSEND Send failed 
PINGSOCKET Unable to obtain socket 



FtpProxy( target Jiost, targetjiserid, - 

target_password, target_account, - 
sourcejiost, sourcejiserid, - 
source password, sourceaccount, - 
targetjfile, source_file[, mode ] ) 
Returns 0 after successfully copying source Jile on th 
remote host designated by source host, source user jc 
source password, and optionally source ^account to th 
remote host designated by target host, target user jc 
target password, and optionally target jiccount; otherwis< 
returns -1 and assigns a value to the predefined vanabl 
FTPERRNO. 

If source _account and/or target ^account are not require 
by their respective hosts, they must be specified as m 
strings. 
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Both source Jile and target Jile can specify different file 
names and can contain path directives. 

Mode is either ASCII or BINARY (or an abbreviation 
of either) and specifies the mode for the file transfer. 

Note: It appears that the default transfer mode is 
binary; however, it is recommended that a mode 
be specified explicitly. 

FtpPut( 1ocal_file, remote_fi1e[, mode ] ) 

Returns 0 after successfully copying local Jile to the 
remote host as remote Jile; otherwise, returns -1 and 
assigns a value to the predefined variable FTPERRNO. 
The remote host is specified with a previous 
FtpSetUser() function call. 

Mode is either ASCII or BINARY (or an abbreviation 
of either) and specifies the mode for the file transfer. If 
mode is omitted, a previous call to FtpSetBinaryO 
determines the mode of transfer. 

Both local Jile and remote Jile can contain path directives 
which will be taken as relative to the current respective 
directory. Localjile can optionally contain a drive 
designation. 

Note: It appears that the default transfer mode is 
binary; however, it is recommended that a mode 
be specified explicitly. 

FtpPutUnique( local_file, remote_fi1 e[, mode ] ) 

Returns 0 after successfully copying local Jile to the 
remote host as remote Jile so long as remote Jile does not 
exist; otherwise, returns -1 and assigns a value to the 
predefined variable FTPERRNO. The remote host is 
specified with a previous FtpSetUserQ function call. 

Mode is either ASCII or BINARY (or an abbreviation 
of either) and specifies the mode for the file transfer. If 
mode is omitted, a previous call to FtpSetBinaryO 
determines the mode of transfer. 

Both local Jile and remote Jile can contain path directives 
which will be taken as relative to the current respective 
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directory. Local Jile can optionally contain a drive 
designation. 

Note 01: Use of FtpPutUnique() rather than FtpPiitQ 
prevents files from unintentionally being over- 
written on the remote host. 

Note 02: It appears tliat the default transfer mode is 
binary; }%owever f it is recommended that a mode 
be specified explicitly. 

FtpPwd( 'current_di rectory' ) 

Returns 0 after successfully assigning the value of the 
current working directory on the remote host to 
current directory, otherwise, returns -1 and assigns a 
value to the predefined variable FTPERRNO. The 
remote host is specified with a previous FtpSetUser() 
function call. 

Note: The variable passed to the function must be 
enclosed in quotes. 

FtpQuote( string ) 

Returns 0 after successfully sending string to the remote 
host as a quoted string; otherwise, returns -1 and assigns 
a value to the predefined variable FTPERRNO. The 
remote host is specified with a previous FtpSetUser() 
function call. The remote server must be enabled to 
allow quoted strings or the function will fail. 

FtpRename( oldjiame, newjiame ) 

Returns 0 after successfully renaming oldjiame to 
newjiame on the remote host; otherwise, returns -1 and 
assigns a value to the predefined variable FTPERRNO. 
The remote host is specified with a previous 
FtpSetUserO function call. 

FtpRmDir( directoryjiame ) 

Returns 0 after successfully removing directoryjiame on 
the remote host; otherwise, returns -1 and assigns a 
value to the predefined variable FTPERRNO. The 
remote host is specified with a previous FtpSetUserO 
function call. 

FtpSetBinary( BINARY | ASCII ) 
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Returns 1 after successfully indicating the default file 
transfer mode to the RxFTP API; otherwise, returns 0 if 
the value passed to the function is neither ASCII nor 
BINARY or a valid abbreviation of either. A valid 
abbreviation may be just the first character. This default 
can be overridden by individual RxFTP functions which 
provide an ASCII vs. BINARY parameter. 

Ftp5etUser( host, user_ID[, account ] ) 

Returns 1 after successfully passing host, userJD, and 
account to RxFTP; otherwise, returns 0 if any of the 
parameters contain invalid strings. These values remain 
in effect until one of the following occurs: 

1) A successful call to FtpLogofff) 

2) A successful call to FtpDropFuncs() and, if running 
under CMD./EXE ( a command line session), the 
session is closed. 

Note: It is advisable to call FtpLogOff() when 
communication with a remote host is complete to 
prevent unauthorized access to the remote Jiost by 
other programs. 

FtpSite( string ) 

Returns 0 after successfully sending string to the remote 
host as a site string; otherwise, returns -1 and assigns a 
value to the predefined variable FTPERRNO. The 
remote host is specified with a previous FtpSetUser() 
function call. The remote server must be enabled to 
allow site strings or the function will fail. 

FtpSys( 'operating^system* ) 

Returns 0 after successfully assigning an identification 
string associated with the operating system on the 
remote host to operating system) otherwise, returns -1 
and assigns a value to the predefined variable 
FTPERRNO. The remote host is specified with a 
previous FtpSetUser() function call. 

Note 01: This function can be used to test for a valid 
connection with a remote host. 

Note 02: The variable passed to the function must be 
enclosed in quotes. 
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FtpVersion( 'version' ) 

Returns a null string after assigning the current versio] 
level of the RxFTP API to version. 

Note: The variable passed to tfie function must h 
enclosed in quotes. 
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000 


'00 


f x 


null 


043 


'2B 


'X 


+ 


085 


'55 


X 


u 


001 


'01 


'X 


SOH 


044 


'2C 


f x 


1 


086 


'56 


X 


V 


002 


'02 


'X 


STX 


045 


'20 


'X 




087 


'57 


X 


w 


003 


'03 


'X 


ETX 


046 


'2E 


r x 




088 


'58 


X 


X 


004 


'04 


'X 


EOT 


047 


'2F 


f x 


/ 


089 


'59 


X 


Y 


005 


'05 


'X 


ENQ 










090 


'5A 


X 


z 


006 


'06 


f x 


ACK 


048 


'30 


'X 


0 


091 


'5B 


X 


[ 


007 


'07 


f x 


BEL 


049 


'31 


X 


1 


092 


'5C 


X 


\ 


008 


'08 


'X 


BS 


050 


'32 


r x 


2 


093 


'5D 


X 


J 


009 


'09 


'X 


HTAB 


051 


'33 


X 


3 


094 


'5E 


X 


A 


010 


'OA 


'X 


LF 


052 


'34 


X 


4 


095 


'5F 


X 




011 


'OB 


'x 


VTAB 


053 


'35 


X 


5 










012 


'OC 


'X 


FF 


054 


'36 


X 


6 


096 


'60 


X 


\ 


013 


'OD 


r x 


CR 


055 


'37 


X 


7 


097 


'61 


X 


a 


014 


'OE 


f x 


SO 


056 


'38 


X 


8 


098 


'62 


X 


b 


015 


'OF 


f x 


SI 


057 


'39 


X 


9 


099 


'63 


X 


c 










058 


'3A 


X 




100 


'64 


X 


d 


016 


'10 


f x 


DLE 


059 


'3B 


X 




101 


'65 


X 


e 


017 


'11 


X 


DC1 


060 


'3C 


X 


< 


102 


'66 


X 


f 


018 


'12 


X 


DC2 


061 


'3D 


X 




103 


'67 


X 


9 


019 


'13 


X 


DC3 


062 


'3E 


X 


> 


104 


'68 


X 


h 


020 


'14 


X 


DC4 


063 


'3F 


X 


? 


105 


'69' 


X 


i 


021 


'15 


X 


NAK 










106 


'6A 


X 


j 


022 


'16 


X 


SYN 


064 


'40 


X 


a 


107 


'6B' 


X 


k 


023 


'17 


X 


ETB 


065 


'41 


X 


A 


108 


'6C 


X 


I 


024 


'18 


X 


CAN 


066 


'42 


X 


B 


109 


'6D 


X 


m 


025 


'19 


X 


EM 


067 


'43 


X 


C 


110 


'6E' 


X 


n 


026 


'W 


X 


SUB 


068 


'44 


X 


D 


111 


'6F' 


X 


0 


027 


MB 


X 


ESC 


069 


'45 


X 


E 










028 


MC 


X 


FS 


070 


'46 


X 


F 


112 


'70' 


X 


P 


029 


MD' 


X 


GS 


071 


'47' 


X 


G 


113 


'71' 


X 


q 


030 


ME' 


X 


RS 


072 


'48' 


X 


H 


114 


'72' 


X 


r 


031 


MF' 


X 


US 


073 


'49' 


X 


I 


115 


'73' 


X 


s 










074 


'4A' 


X 


J 


116 


'74' 


X 


t 


032 


'20' 


X 


sp. 


075 


'4B' 


X 


K 


117 


'75' 


X 


u 


033 


'21' 


X 


1 


076 


'4C 


X 


L 


118 


'76' 


X 


V 


034 


'22' 


X 


II 


.077 


'4D' 


X 


M 


119 


'77' 


X 


w 


035 


'23' 


X 


# 


078 


'4E 


X 


N 


120 


'78' 


X 


X 


036 


'24' 


X 


$ 


079 


'4F' 


X 


0 


121 


'79' 


X 


y 


037 


'25' 


X 


% 










122 


'7A' 


X 


z 


038 


'26' 


X 


& 


080 


'50' 


X 


P 


123 


'7B' 


X 


<: 


039 


'27' 


X 


/ 


081 


'51' 


X 


Q 


124 


'7C 


X 




040 


'28' 


X 


( 


082 


'52 


X 


R 


125 


'7D 


X 


> 


041 


'29' 


X 


) 


083 


'53 


X 


S 


126 


'7E 


X 




042 


'2A' 


X 


* 


084 


'54 


X 


T 


127 


'7F 


X 





©1993-1997 by C F S Nevada, /Inc. 209 Rev 4.0 



128 '80'x C 

129 '81'x u 

130 '82'x § 

131 '83'x a 

132 '84'x a 



133 


'85'x 


a 


134 


'86'x 


a 


I D j 


Of A 


V 


1XA 


OO A 




1X7 


07 A 




1 JO 


'8A'x 




1XO 


'8B' x 


] 


If u 


'8C'x 


] 


1A1 
if i 


OU A 


1 


1 L"> 
If c 


OC A 


A 


1£X 
I f j 


'8F'x 




1 Ht 


' 90 ' x 




1 f «J 


'91 'x 


9 


If O 


7b A 




I f I 


7J A 


o 


1 Aft 
I to 


'94' x 


Q 


149 


'95'x 


6 


150 


'96'x 


0 


151 
i j \ 


'97'x 




15? 


'98' x 


s 


T5X 


'99'x 


o 


154 


'9A'x 


u 


155 


'9B'x 




156 


'9C'x 


£ 


157 


'9D'x 


¥ 


158 


'9E'x 




159 


'9F'x 


/ 


1 An 


' AO'x 


g 


161 


'A1'X 


1 


162 


'A2'x 


6 


163 


'A3'x 


u 


164 


'A4'x 


n 


165 


'A5'x 


fi 


166 


'A6'x 


i 


167 


'A7'x 


2 


168 


'A8'x 




169 


'A9'x 




170 


'AA'x 





171 


'AB'x 




172 


'AC'x 


y* 


173 


'AD'X 


i 


174 


'AE'X 


« 


175 


'AF'x 


» 



176 'BO'x 



177 'Bl'x 1 

178 'B2'x 1 

179 'B3'x | 



180 


'B4'x 


-I 


181 


'B5'x 


^ 


182 


'B6'x 




183 


'B7'x 




184 


'B8'x 




185 


'B9'x 




186 


'BA'x 




187 


'BB'x 




188 


'BC'x 


j 


189 


'BD'x 


j 


190 


'BE'X 




191 


'BF'x 




192 


'CO'x 


L 


193 


'C1 'x 


i 

_L 


194 


'C2'x 


T 


195 


'C3'x 


} 


196 


'C4'x 




197 


'C5'x 


+ 


198 


'C6'x 


1- 


199 


'C7'x 


I 


200 


'C8'x 


I 


201 


'C9'x 


r 


202 


'CA'x 


jl 


203 


'CB'x 


T 


204 


'CC'x 


} 


205 


'CD'x 




206 


'CE'x 


I 


207 


'CF'x 


X 


208 


'DO'x 


1 


209 


'Dl'x 


T 


210 


'D2'x 


T 


211 


'D3'x 


L 


212 


'D4'x 


L 



213 'D5'x r 

214 'D6'x r 

215 'D7'x | 

216 'D8'x + 

217 'D9'x J 

218 'DA'x r 

219 'DB'x | 

220 'DC'x a 

221 'DD'x | 

222 'DE'x | 

223 'DF'x ■ 

224 'EO'x a 

225 'E1'x B 

226 'E2'x r 

227 'E3'x it 

228 'E4'x S 

229 'E5'x a 

230 'E6'x pl 

231 'E7'x r 

232 >E8'x * 

233 'E9'x 0 

234 'EA'x H 

235 'EB'x S 

236 'EC'x > 

237 'ED'x 0 

238 'EE'x e 

239 'EF'x n 

240 'FO'x '« 

241 'FVx ± 

242 'F2'x > 

243 'F3'x < 

244 'F4'x f 

245 'F5'x J 

246 'F6'x + 

247 'F7'x * 

248 'FB'x 0 

249 'F9'x • 

250 'FA'x • 

251 'FB'x V 

252 'FC'x n 

253 'FD'x 2 

254 'FE'x ■ 

255 'FF'x 
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Only 


Shft 


Ctrl 


Alt 


Alt 
Ctrl 


Ctrl 
Shft 


Alt 
Shft 


DclLlvoUaLC? 


08 


08 


7F 


000E 


000E 


7F 


000E 


Pi ir Hnun 


E050 


E050 


E091 


0OA0 


00A0 


E091 


00A0 




0050 


32 


0091 


02 


02 


0091 


02 


Cur Left 


E04B 


E04B 


E073 


009B 


009B 


E073 


009B 


Pur Left (KP) 

LUI LCI w \ ivr / 


0046 


34 


0073 


04 


04 


0073 


04 




004C 


35 


008F 


05 


05 


008F 


05 


Pur Piaht 
lui iv i yi i l 


E04D 


E04D 


E074 


0090 


009D 


E074 


009D 


Cur Riaht (KP) 

LUl i\iynw \ i\.r / 


004D 


36 


0074 


06 


06 


0074 


06 


Cur Up 


E048 


E048 


E08D 


0098 


0098 


E08D 


0098 


Cur Ud (KP) 

LUI UJJ \ ivr / 


0048 


38 


008D 


08 


08 


008D 


08 




E053 


E053 


E093 


00A3 


Oops 


E093 


00A3 


DeLete (KP) 


0053 


2E 


0093 




Oops 


0093 




End 


E04F 


E04F 


E075 


009F 


009F 


E075 


009F 


tna \N.r/ 


004F 


31 


0075 


01 


01 


0075 


01 


Enter 


0D 


0D 


OA 


001C 


001C 


OA 


001C 


Cntpr (VP'S 


0D 


0D 


OA 


00A6 




OA 


00A6 


Escspe 


1B 


1B 














E047 


E047 


E077 




0097 


E077 


0097 


home (KP) 


0047 


37 


0077 


07 


07 


0077 


07 


I nsert 


E052 


E052 


E092 


00A2 


00A2 


E092 


00A2 


Insert (KP) 


0052 


30 


0092 






0092 




Paae Down 


E051 


E051 


E076 


00A1 


00A1 


E076 


00A1 


Page Down (KP) 


0051 


33 


0076 


03 


03 


0076 


03 


Page Up 


E049 


E049 


E084 


0099 


0099 


E084 


0099 


Paae Un (KP) 


0049 


39 


0084 


09 


09 


0084 




Criflrp Bar 
opauc Dai 


20 


20 


20 


20 


20 


20 


20 


Tab 


09 


000F 


0094 


00A5 


00A5 


0094 


00A5 


F1 


003B 


0054 


005E 


0068 


0068 


005E 


0068 


F2 


003C 


0055 


005 F 


0069 


0069 


005 F 


0069 


F3 


003D 


0056 


0060 


006A 


006A 


0060 


006A 


F4 


003E 


0057 


0061 


006B 


006B 


0061 


Q06B 


F5 


003 F 


0058 


0062 


006C 


006C 


0062 


006C 


F6 


0040 


0059 


0063 


006D 


006D 


0063 


006D 


P7 


0041 


005A 


0064 


006E 


006E 


0064 


006E 


ro 


0042 


005B 


0065 


006F 


006F 


0065 


006F 


F9 


0043 


005C 


0066 


0070 


0070 


0066 


0070 


F10 


0044 


005D 


0067 


0071 


0071 


0067 


0071 


F11 


0085 


0087 


0089 


008B 


008B 


0089 


008B 


F12 


0086 


0088 


008A 


008C 


008C 


008A 


008C 
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Alt Ctrl Alt 
nnlv Shft Ctrj Alt Ctrl Shft Shft 

0 30 29 -- 0081 0081 - 0081 

0 (KP - ML) 30 0052 0092 . . " 0092 

" 31 21 - 0078 0078 0078 

(KP - ML) 31 004F 0075 01 01 0075 01 

' K 32 40 0003 0079 0079 0003 0079 

2 (KP - ML) 32 0050 0091 02 02 0091 02 
\ 33 23 - 007A 007A - 007A 

3 (KP - NL) 33 0051 0076 03 03 0076 03 

1 34 24 - 007B 007B 007B 

4 (KP - NL) 34 004B 0073 04 04 0073 04 
c 35 25 - 007C 007C - 007C 

5 (KP - NL) 35 004C 008F 05 05 008F 05 
I 36 5E 1E 007D 007D 1E 007D 

6 (KP - NL) 36 004D 0074 06 06 0074 06 

7 ^ 37 26 - 007E 007E -- 007E 
7 (KP - NL) 37 0047 0077 07 07 0077 07 
' C 38 2A - 007F 007F -- 007F 
o , KP - NL > 38 0048 008D 08 08 008D 05 
p 39 28 - 0080 0080 - 0080 
9 (KP - ML) 39 0049 0084 09 09 0084 09 



A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

P 

Q 

R 

S 

T 

U 

V 

w 

X 
Y 

z 



61 


41 


01 


001E 


001E 


01 


001 E 


62 


42 


02 


0030 


0030 


02 


0030 


63 


43 


- 03 


002E 


002E 


- 03 


002E 


64 


44 


04 


0020 


0020 


04 


0020 


65 


45 


05 


0012 


0012 


05 


0012 


66 


46 


06 


0021 


0021 


06 


0021 


67 


47 


07 


0022 


0022 


07 


0022 


68 


48 


08 


0023 


0023 


08 


0023 


69 


49 


09 


0017 


0017 


09 


0017 


6A 


4A 


OA 


0024 


0024 


OA 


0024 


6B 


4B 


OB 


0025 


0025 


OB 


0025 


6C 


4C 


0C 


0026 


0026 


OC 


0026 


6D 


40 


OD 


0032 


0032 


OD 


0032 


6E 


4E 


OE 


0031 


0031 


OE 


0031 


6F 


4F 


OF 


0018 


0018 


OF 


0018 


70 


50 


- 10 


0019 


0019 


- 10 


0019 


71 


51 


11 


0010 


0010 


11 


0010 


72 


52 


12 


0013 


0013 


12 


0013 


73 


53 


- 13 


001 F 


001 F 


- 13 


001 F 


74 


54 


14 


0014 


0014 


14 


0014 


75 


55 


15 


0016 


0016 


15 


0016 


76 


56 


16 


002F 


002F 


16 


002F 


77 


57 


17 


0011 


0011 


17 


0011 


78 


58 


18 


002D 


002D 


18 


002D 


79 


59 


19 


0015 


0015 


19 


0015 


7A 


5A 


1A 


002C 


002C 


1A 


002C 
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Only 


sntt 


pf » i 
utn 


Alt- 
MIT. 


Alt 

til I 


Ctrl 
Shft 


Alt 
Shft 






27 


22 




0028 


0028 


-- 


0028 


* 


(KP) 


2A 


2A 


0096 


0037 


0037 


0096 


0037 


+ 


<KP) 


2B 


2B 


0090 


004E 




0090 


004E 






2C 


3C 




0033 


0033 


-- 


0033 






2D 


5F 


1F 


0082 


0082 


IF 


0082 




(KP) 


2D 


2D 


008E 


004A 


004A 


008E 


004A 






2E 


3E 




0034 


0034 




0034 


/ 




2F 


3F 




0035 


0035 




0035 


/ 


(KP) 


2F 


2F 


0095 


00A4 


00A4 


0095 


00A4 




3B 


3A 




0027 


0027 




0027 


_ 




3D 


2B 




0083 


0083 




0083 


_ 


(KP) 


3D 


3D 




0083 


0083 




0083 


[ 




5B 


7B 


1B 


001A 


001A 


1B 


001A 


\ 




5C 


7C 


1C 


002B 


002B 


1C 


002B 


] 




5D 


7D 


1D 


001B 


001B 


1D 


001B 






60 


7E 




0029 


0029 




0029 



The 2 or 4 byte hexadecimal values shown above are returned 
by SysGetKey() when the respective key, shown in the first 
column, by itself or along with the combinations of the Shift 
key, the Ctrl key or the Alt key are depressed. The leading 
H E0" is returned when the instruction keys (e.g. Home, Page 
Up, etc.) separate from the numeric keypad are used. 

These same instruction keys, which are part of the numeric 
keypad (noted with KP above and typically white rather than 
grey), return a 2 byte hexadecimal value with the "E0" 
replaced with "00". KP NL indicates the keypad number keys 
with numeric lock set to on. 

r- indicates the values for the respective keys; however, these 
values are retained by OS/2 for its own use and not returned 
to a Rexx program. 
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Foreground Colors 


Background Colors 


0 - black 


0 - black 


1 - blue 


16 - blue 


2 - green 


32 - green 


3 - cyan 


48 - cyan 


4 - red 


64 - red 


5 - magenta 


80 - magenta 


6 - brown 


96 - brown 


7 - white 


112 - white 


8 - gray 




9 - light blue 




10 - light green 




11 - light cyan 




12 - light red 




13 - light magenta 




14 - yellow 




15 - high intensity white 





Attribute values are computed by adding the number that 
represents the foreground color to the number that represents 
the background color. 

If the blinking attribute is enabled, as it is by default, adding 
128 will produce blinking text. If the blinking attribute is 
disabled with the SCRBLINK function, adding 128 will 
produce text with bright background colors. 
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Appendix D: REXX Error Codes 
(from REX. MSG and REXH.MSG) 



Error codes 1 through 114 are reserved for the REXX 
interpreter. Error codes 115 through 125 are used by REXX 
subcommands. 

Return codes from the REXX macrospace functions are listed 
at the end of this Appendix. 

01 File Table full 

There are currently too many files open for this 
session. 

Close files which are open but no longer in use. 

02 not used 

03 Program is unreadable 

| 03 Failure during initialization (OBJ) 

An attempt was made to access a program which was 
either non-existent or locked by another process. Verify 
the program file's existence and make sure no other 
process has it locked. 

04 Program interrupted 

The system interrupted execution of a program because 
of some error, or by user request. 

Trap interrupts via CALL ON HALT or SIGNAL ON 
HALT. 

05 Machine resources exhausted 

| 05 System resources exhausted (OBJ) 

While attempting to execute a program, the language 
processor was unable to obtain the resources it needed 
to continue execution. 

06 Unmatched "/*" or quote 

A comment or literal string was started but never 
finished. This may be detected at the end of the program 
(or the end of data in an INTERPRET instruction) for 
comments, or at the end of a line for strings. 
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07 WHEN or OTHERWISE expected 

Within a SELECT construct, at least one WHEN 
construct (and possibly an OTHERWISE clause) is 
expected. 

Look for any instruction other than WHEN (or no 
WHEN construct before the OTHERWISE) in the 
SELECT construct. 

08 Unexpected THEN or ELSE 

A THEN or an ELSE has been found that does not 
match a corresponding IF (or WHEN) clause. 

Look for a missing END or DO...END in the THEN 
part of a complex IF... THEN... ELSE construction. 

09 Unexpected WHEN or OTHERWISE 

A WHEN or an OTHERWISE has been found outside 
of a SELECT construct. It may have been enclosed 
unintentionally in a DO...END construct by leaving off 
an END instruction, or an attempt may have been made 
to branch to it with a SIGNAL instruction. 

10 Unexpected or unmatched END 

There are more END's in the program than DO's and 
SELECT'S, or the END's are wrongly placed so they do 
not match the DO's and SELECT'S. This error will also 
be generated if an END immediately follows a THEN or 
an ELSE. 

Putting the name of the control variable on END's that 
close repetitive loops can also help locate this kind of 
error, A common mistake that causes this error is 
attempting to jump into the middle of a loop using the 
SIGNAL instruction. Since the previous DO will not 
have been executed, the END is unexpected. Also, since 
SIGNAL deactivates any current loops, it may not be 
used to jump from one place inside a loop to another. 
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11 Control stack full 

An interpreter limit of levels of nesting of control 
structures (DO...END, IF... THEN... ELSE, etc.) has been 
exceeded. This could be due to a looping INTERPRET 
instruction, which could loop forever. Similarly, a 
recursive subroutine or internal function that does not 
terminate correctly could loop forever. 

12 Clause too long 

The length of the internal or external representation of 
a clause has exceeded the interpreter's limit. 

13 Invalid character in program 

The program includes a character outside of a literal 
(quoted) string that is not a blank or one of the valid 
alphanumeric/special characters. 

14 Incomplete DO/SELECT/IF 

On reaching the end of the program (or end of the 
string in an INTERPRET instruction), it has been 
detected that there is a DO or SELECT without a 
matching END, or an IF that is not followed by a THEN 
clause to execute. 

Putting the name of the control variable on END's that 
close repetitive loops can also help locate this kind of 
error. 

15 Invalid hexadecimal or binary string 

Hexadecimal strings may not have leading or trailing 
blanks, and may only have embedded blanks at byte 
boundaries. Only the digits 0-9 and the letters a-f and A- 
F are allowed. Similarly, binary strings may only have 
blanks added at the boundaries of groups of four binary 
digits, and only the digits 0 and 1 are allowed. 

This error may also be caused by following a literal 
string by the one-character symbol "X" (for example the 
name of the variable X) when the string is not intended 
to be taken as a hexadecimal specification, or by the 
symbol "B" when the string is not intended to be taken 
as a binary specification. 
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Use the explicit concatenation operator, " 1 1 ", in 
situations where the "X" or H B" is intended to represent 
a variable. 

Label not found 

A SIGNAL instruction has been executed (or an event 
for which a trap was set has occurred), and the label 
specified cannot be found in the program. 

Unexpected PROCEDURE 

A PROCEDURE instruction was encountered which 
was not the first instruction executed after a CALL or 
function invocation. 

Check for the possibility of "dropping through" into an 
internal routine rather than invoking it properly. 

THEN expected 

All IF clauses and WHEN clauses in REXX must be 
followed by a THEN clause. Some other clause was 
found when a THEN was expected. 

String or symbol expected 

Following either the keyword CALL or the sequence 
SIGNAL ON or SIGNAL OFF, a literal string or a 
symbol was expected but neither was found. 

Symbol expected 

In the clauses CALL ON, END, ITERATE, LEAVE, 
NUMERIC, PARSE, PROCEDURE, and SIGNAL ON, 
a symbol can be expected. Either it was not present 
when required, or some other token was found. 
Alternatively, DROP, and the EXPOSE option of 
PROCEDURE, expect a list of symbols. Some other 
token was found. 

Invalid data on end of clause 

\ clause such as SELECT or NOP is followed by some 
token other than a comment. 
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22 Invalid character string 

This error results if a literal string contains character 
codes that are not valid in the interpreter. This might be 
because some characters are "impossible", or because the 
character set is extended in some way and certain 
character combinations are not allowed. 

23 Invalid data string 

This error results if a data string (result of an expression, 
etc.) contains character codes that are not valid in the 
interpreter. This might be because some characters are 
"impossible", or because the character set is extended in 
some way and certain character combinations are not 
allowed. 

24 Invalid TRACE request 

The setting specified on a TRACE instruction starts with 
a character that does not match one of the valid 
TRACE settings (i.e., A, C, E, F, I, L, N, O, or R). 

25 Invalid sub-keyword found 

An unexpected token has been found in the position in 
an instruction where a particular sub-keyword was 
expected. For example, in a NUMERIC instruction, the 
second token must be DIGITS, FUZZ, or FORM, and 
anything else is an error. 

26 Invalid whole number 

One of the following did not evaluate to a whole 
number: 

• the positional patterns in parsing templates 

• the power value (right-hand operand) of the power 
operator 

• the values in a DO instruction after the FOR 
modifier - the values given for DIGITS or FUZZ in 
the NUMERIC instruction 

• the number used in the TRACE setting 

This error is also raised if the value is not permitted (for 
example, a negative repetition count in a DO 
instruction), or when the division performed during an 
integer divide or remainder operation does not result in 
a whole number. 
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27 Invalid DO syntax 

Some syntax error has been found in the DO instructio: 
This might be by using BY, TO, or FOR twice, or usir 
BY, TO, or FOR when there is no control variafr 
specified, etc. 

28 Invalid LEAVE or ITERATE 

A LEAVE or ITERATE instruction was encountered i 
an invalid position. Either no loop is active, or the nair 
specified on the instruction does not match the contn 
variable of any active loop. Note that since intern; 
routines and the INTERPRET instruction protect D( 
loops, they become inactive, and therefore a LEAVE i 
a subroutine cannot affect a DO loop in the callin 
routine. A common cause for this error message 
attempting to use the SIGNAL instruction to transfe 
control within or into a loop. Since SIGNAL terminate 
all active loops, an ITERATE or LEAVE would then b 
in error. 

29 Environment name too long 

The environment name specified by the ADDRES 
instruction is longer than permitted for the system unde 
which the interpreter is executing. 

30 Name or string too long 

A variable name or a label name (or the length of 
literal string) has exceeded the interpreter's limit. 

31 Name starts with number or 

A value may not be assigned to a variable whose nam 
starts with a numeric digit or a period (since if it wer 
permitted one could re-define numeric constants). 

32 not used 

33 Invalid expression result 

The result of an expression in an instruction was foun 
to be invalid in the particular context in which it wa 
used. 

Check for an illegal FUZZ or DIGITS value in 
NUMERIC instruction (FUZZ may not become large 
than DIGITS). 



©1993-1997 by C F S Nevada, Inc. 220 Rev 4j 



Appendix D: REXX Error Codes 



34 Logical value not 0 or 1 

The expression in an IF, WHEN, DO WHILE, or DO 
UNTIL phrase must result in a '0' or a T, as must any 
term operated on by a logical operator. 

35 Invalid expression 

This is due to a grammatical error in an expression, such 
as ending it with an operator, or having two operators 
adjacent with nothing in between. It may also be due to 
an expression that is missing when one is required. 

Check for special characters (such as operators) in an 
intended character expression which are not enclosed in 
quotes. 

36 Unmatched "(" or "[" in expression 

This is due to not pairing parentheses or brackets 
correctly within an expression. There are more left 
parentheses or brackets than right parentheses or 
brackets. 

37 Unexpected V\ ")", or "]" 

Either a comma has been found outside a function 
invocation, or there are too many right parentheses or 
brackets in an expression. 

38 Invalid template or pattern 

Within a parsing template, a special character that is not 
allowed (for example, "%") has been found, or the syntax 
of a variable pattern is incorrect (i.e., no symbol was 
found after a left parenthesis). This error may also be 
raised if the WITH sub-keyword is omitted in a PARSE 
VALUE instruction. 

39 Evaluation stack overflow 

The expression is too complex to be evaluated by the 
language processor. 

Check for too many nested parentheses, functions, etc. 
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40 Incorrect call to routine 

The specified built-in or external routine does exist, but 
it has been used incorrectly. Either invalid arguments 
were passed to the routine, or the program invoked was 
not compatible with the language processor, or more 
than an implementation-limited number of arguments 
were passed to the routine. 

41 Bad arithmetic conversion 

One of the terms involved in an arithmetic operation is 
not a valid number, or its exponent exceeds the 
implementation limit (often 9 digits). 

42 Arithmetic overflow/underflow 

The result of an arithmetic operation requires an 
exponent that is outside the range supported by the 
interpreter. This can happen during evaluation of an 
expression (commonly an attempt to divide a number by 
0), or possibly during the stepping of a DO loop control 
variable. 

43 Routine not found 

A function has been invoked within an expression (or a 
subroutine has been invoked by a CALL) but it cannot 
be found. No label with the specified name exists in the 
program, it is not the name of a built-in function, and 
the language processor has been unable to locate it 
externally. 

Check for: 

• a mis-typed label or name 

• a symbol or literal string adjacent to a '(' when it 
should have been separated by a blank or some 
other operator (this would be understood as a 
function invocation) 

Function or message did not return data 

An external function has been invoked within an 
expression, but even though it appeared to end without 
error, it did not return data for use within the 
expression. 



I 44 
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45 No data specified on function RETURN 

The program has been called as a function, but an 
attempt is being made (by RETURN;) to return without 
passing back any data. Similarly, if an internal routine is 
called as a function then the RETURN instruction that 
ends it must specify an expression. 

46 Invalid variable reference 

Within a DROP, PARSE or PROCEDURE instruction, 
the syntax of a variable reference is incorrect. This may 
be due to a missing parenthesis or an incorrectly coded 
variable within the parentheses. 

47 Unexpected label 

A label appeared as part of the instructions executed by 
an INTERPRET instruction. 

Remove the label from the inteipreted data. 

48 Failure in system service 

A system service used by the language processor (such 
as stream input or output, or manipulation of an 
external data queue) has failed to work correctly and 
hence normal execution cannot continue. 

49 Interpretation error 

Some kind of severe error has been detected within the 
language processor or execution process during internal 
self-consistency checks. 

90 External name not found (OBJ) 

An external class, method, or routine (specified with the 
EXTERNAL option on a ::CLASS, ::METHOD, or 
::ROUTINE directive cannot be found. 

91 No result object (OBJ) 

A message term requires a result object, but the method 
did not return one. 

93 Incorrect call to method (OBJ) 

The specified method or built-in or external routine does 
exist, but you used it incorrectly. The associated error 
subcode will give the specific reason for the error. 
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97 Object method not found (OBJ) 

This message indicates that the object does not have i 
method with the given name. A frequent cause of thij 
error is an uninitialized variable. 

98 Execution error (OBJ) 

This message indicates that the language processoi 
detected one of certain errors in execution. The 
associated error will give the specific reason for the 
error. 

99 Translation error (OBJ) 

This message indicates that some error was detected ii 
the language syntax. The associated error subcode 
identifies the specific syntax error. 

Note: Message numbers 50-114 are unused in Classic 
REXX. Only the messages shown from 90 - % 
are used in this range in Object REXX. 
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115 RXSUBCOM accepts the following parameters: 

To Register a subcommand environment: 

RXSUBCOM REGISTER ENVIRONMENT NAME - 

-> DLL_NAME ENTRYJ>OINT 

To Query a specific subcommand environment for 
existence: 

RXSUBCOM QUERY [ENVI RONMENT_NAME [DLL_NAME] 3 

To Drop a subcommand environment handler: 
RXSUBCOM DROP ENVI RONMENT_NAME [DLLJIAME] 

To Load a subcommand environment from disk: 
RXSUBCOM LOAD ENVI RONMENT_NAME [DLL_NAME] 

Note: Check the RXSUBCOM parameters and retry. 

116 The RXSUBCOM parameter REGISTER is incorrect. 

RXSUBCOM REGISTER requires all of the following 
parameters: 

REGISTER ENVI RONMENT_NAME DLL_NAME ENTRY J>OINT 

Environment name is the name of the subcommand 
environment. 

DLLname is the Dynamic Link Library module name. 

Entry jpoint is the name of the function to be executed 
when called. 

Note: Check the RXSUBCOM parameters and retry the 
command. 

117 The RXSUBCOM parameter DROP is incorrect. 

RXSUBCOM DROP requires the environment name be 
specified: 

RXSUBCOM DROP ENVI RONMENT_NAME [DLl_NAME] 

Environment jiame is the name of the subcommand 
environment. 

DLL name is the Dynamic Link Library module name 
(optional). 

Note: Check the RXSUBCOM parameters and retry the 
command. 
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118 The RXSUBCOM parameter LOAD is incorrect. 

RXSUBCOM LOAD requires the environment name be 
specified. 

RXSUBCOM LOAD ENVI RONMENT_NAME [DLLJIAME] 

Environment name is the name of the subcommand 
environment. 

DLL name is the Dynamic Link Library module name 
(optional). 

Note: Check the RXSUBCOM parameters and retry the 
command. 

119 The REXX queuing system is not initialized. 

The queuing system requires a housekeeping program to 
run. This program usually runs under the Presentation 
Manager shell. The program is not running. 

Note: Report this message to your IBM service 
representative or facility. 

120 The size of the data is incorrect. 

The data supplied to the RXQUEUE command is too 
long. The RXQUEUE.EXE program accepts data 
records containing 0 - 65472 bytes. A record exceeded 
the allowable limits. 

Note: Use shorter data records. 

121 Storage for data queues is exhausted. 

The queuing system is out of memory. No more storage 
is available to store queued data. 

Note: Delete some queues or remove queued data from 
the system. Then retry your request. 

122 The name %1 is not a valid queue name. 

The queue name contains an invalid character. Only the 
following characters may appear in queue names: 

/a' '7' '0' '9' ' ' fit ' ' 

Note: Change the queue name and retry the command. 
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| 123 The queue access mode is not correct. 

An internal error occurred in RXQUEUE. 
RXQUEUE.EXE tried to access a queue with an 
incorrect access mode. Correct access modes are LIFO 
and FIFO. 

Note: Report this message to your IBM service 
representative or facility. 

| 124 The queue %1 does not exist. 

The command attempted to access a nonexistent queue. 
Create the queue and tiy again, or use a queue that has 
been created. 

j 125 The RXSUBCOM parameter QUERY is incorrect. 

RXSUBCOM QUERY requires the environment name 
be specified. 

RXSUBCOM QUERY ENVIRONMENT_NAME [DLLJIAME] 

Environment jiame is the name of the subcommand 
environment. 

DLLname is the Dynamic Link Library module name 
(optional). 

Note: Check the RXSUBCOM parameters and retry the 
command. 
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| Macrospace return codes 

0 The call to the function completed successfully. 

1 There was not enough memory to complete tin 
requested function. 

2 The requested function was not found in thi 

macrospace. 

3 An extension is required for the macrospace file name. 

4 Duplicate functions cannot be loaded from a macrospao 

file. , . , 

5 An error occurred accessing a macrospace file. 

6 A macrospace save file does not contain valid functio 

images. 

7 The requested file was not found. 

8 An invalid search order position request flag was used. 
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° annotation 

Leading zeroes suppressed 2 

.INI 

Syslni function 48 

\PIPE\pipename 

SysWaitNamedPipe function 59 

_ACTIVATION_FIELD special variable , 104 

_ACTIVATION_KEY special variable 104 

ACTIVATIONJCEYNAME special variable . . . 101, 104 

~ Object REXX Message Send Character 4 

2>&1 

Combined redirection of STDOUT and STDERR . 15 

ABBREV 16 

ABS 16 

ACOS 62 

ADDRESS 

function 16 

instruction 6 

Always maintain sort order setting . 132 

ALWAYSSORT . . 132, 196 

APIs 

Application Program Interface modules 36 

APPDEFAULT . 157, 195 

Appendix A 

ASCII and IBM Character Set 209 

Appendix B 

Codes Returned By SysGetKey 211 

Appendix C 

REXXLIB Video Attributes 214 

Appendix D 

Macrospace return codes . . 228 

REXX Error Codes 215 

ARG 

option of PARSE instruction 9 

Array functions 

ARRAYCOPY 62 

ARRAYDELETE 62 

ARRAYINSERT 62 

ARRAYSEARCH . 62 

ARRAYSORT 64 

CVCOPY 65 

CVREAD . 65 

CVSEARCH 65 

CVTAILS ... 66 
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CVWRITE . . 66 

FILEREAD 81 

FILESEARCH . . 82 

FILEWRITE . 83 

VARDUMP 98 

VARREAD 98 

VARWRITE .98 

ARRAYCOPY . 62 

ARRAYDELETE 62 

ARRAYINSERT 62 

ARRAYSEARCH . . 62, 63 

ARRAYSORT 64 

ASCII 

FILETRANSFERTYPE setting 145 

ASIN 64 

ASSOCFILTER 161, 195, 196 

ASSOCTYPE 39, 161, 195, 196 

ATAN 64 

ATAN2 . . . 64 

Attributes, extended 

DOSEALIST function 72 

DOSEASIZE function . . . . 72 

SysGetEA function 47 

SysPutEA function 52 

SysQueryEAList function 53 

Attributes, file 

DOSCHMOD function . 67 

DOSDIR function 69 

SysFileTree function . 45 

Attributes, video 

Appendix C 214 

SCRBLINK function . 92 

SCRBORDER function 92 

SCRCLEAR function . . . . 92 

SCROLLDOWN function 93 

SCROLLLEFT function 93 

SCROLLRIGHT function 94 

SCROLLUP function 94 

SCRPUT function . . 94 

SCRREAD function 94 

SCRWRITE function 95 

STRINGIN function 96 

W ATTR function . .... 99 

W BORDER function 99 

W CLEAR function 99 
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W_FIELD function . 100 

WJ3ET function 100 

W_OPEN function 103 

WJPUT function 103 

W_SCRWRITE function 106 

AUDIO_ADAPTER_SHARING 181 

AUTOLOCKUP 129 

AUTOSETUP 128, 129, 143, 166 

B2X 17 

BACKGROUND 132, 133 

BAD 

Return from SYMBOL function 31 

Basic Fundamentals and Structure 2 

BEEP 17, 95 

BINARY 

FILETRANSFERTYPE setting 145 

Binary notation . . . . N . 2 

Binary to hexadecimal 

B2X function 17 

BITAND 17 

BITOR 17 

BITXOR 17 

Boot drive identification 

DOSBOOTDRIVE function 67 

SysBootDrive function 38 

BOTH 

option of Syslni function 48 

Branching, unconditional 

SIGNAL instruction 11 

BROWSER 

WPUrl object 167 

Built-in Functions 6, 14-16, 37, 44, 66, 222, 223 

BY 

option of DO instruction 7 

C2D 17 

C2X 18 

CALL 4, 6, 7 

return expression 11 

Return from CONDITION function 19 

Case, alphabetic 

ARG instruction 6 

DATATYPE function 20 

LOWER function 84 
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option of PARSE instruction . . . 9 

PULL instruction 10 

SysFileSearch function 44 

SysMapCase function . . 49 

TRANSLATE function 32 

UPPER 10 

UPPER function 97 

use 2 

CCVIEW 150, 195 

CDFS file system identification 

DOSFILESYS function . 74 

SysFileSystemType function 45 

CENTER 18, 116, 137, 151 

Character mode text box 

CHARSIZE function 64 

Character to decimal 

C2D function 17 

Character to hexadecimal 

C2X function 18 

CHARIN 18, 37, 73 

CHAROUT 18, 37, 73 

CHARS 19, 37, 73 

CHARSIZE 64 

Class 

DOSPRIORITY function 76 

SysCreateObject function 40 

SysDeregisterObjectClass function 42 

SysQueryClassList function 53 

SysRegisterObjectClass function . . . . 53 

Classes 

WPS Objects for Warp 3 123 

WPS Objects for Warp 4 124 

WPS Objects prior to Warp 3 . 121 

Clearing the screen 

SCRCLEAR function 92 

SysCls function 39 

Close a named pipe 

NMPIPE_CLOSE function 86 

Close event semaphore 

EVENTSEM CLOSE function 80 

SysCloseEventSemaphore function 39 

Close mutual exclusion semaphore 

MUTEXSEM_CLOSE function 85 

SysCloseMutexSem function 39 

CLOSE option 
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STREAM function 29 

Code page 

SysGetCollate function 47 

SysMapCase function 49 

SysNationalLanguageCompare function 50 

SysQueryProcessCodePage function 53 

SysSetProcessCodePage function 57 

COLORS 92, 128, 167, 196, 214 

COM_DIRECT_ACCESS 181 

COM__HOLD 179 } 181 

COMRECEIVEBUFFERFLUSH . ' 182 

COMJSELECT 1 83 

Command file location 

DOSCOMMANDFIND function 67 

Command redirection 

ADDRESS instruction 6 

Comments 2 

COMPARE ..............[[ ' 19 

Comparisons 

normal 4 

strict 4 

SysNationalLanguageCompare function 50 

Complete a transaction across a named pipe 

NMPIPEJTRANSACT function 87 

Compound variables 3 

Connect to a named pipe 

NMPIPE_CONNECT function 86 

COPIES 20 

cos 65 

COSH 65 

CRC (Cyclic Redundancy Check) calculation 

FILECRC function 81 

STRINGCRC function 95 

Create a named pipe 

NMPIPE CREATE function 86 

Create directory 

DOSMAKEDIR function 75 

DOSMKDIR function 75 

SysMkDir function 49 

Create event semaphore 

EVENTSEM^CREATE function 80 

SysCreateEventSem function 40 

Create mutual exclusion semaphore 

MUTEXSEM CREATE function . 85 

SysCreateMutexSem function 40 
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Current directory 

DIRECTORY function 21 

DOSCD function 67 

DOSCHDIR function 67 

SETLOCAL function 28 

Current drive 

DOSCD function . . . 67 

DOSDISK function 71 

DOSDRIVE function 72 

DOSFILESYS function 74 

DOSTEMPNAME function 78 

SETLOCAL function 28 

CURSOR / 42, 65, 95, 96, 102, 104, 147 

Cursor position 1 

CURSOR function 65 

SysCurPos function . . . . 42 

. W_KEYS function ...<r. . . 102 

Cursor state 

SysCurState function 42 

CursorBlinkRate . 147 

CURSORTYPE 65 

CVCOPY 65 

CVREAD • • • 65 

CVSEARCH 63, 65 

CVTAILS 66 

CVWRITE 65,66 

D2C 20 

D2X 20 

DATATYPE 20 

DATE 21 

Date replacement 

DOSFDATE function 73 

DATECONV 66 

DATETIME option 

STREAM function 30 

DBCS 

Double-byte character set . 9, 20 

DBTAGS.DAT , 

Default DOS Settings 180 

Debugging 

TRACE instruction 13 

Decimal to character 

D2C function . . 20 

Decimal to hexadecimal 
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D2X function 20 

DEFAULTBROWSER 167 

DEFAULTDISPLAYIMAGES 168 

DEFAULTEMAILADDRESS 169 

DEFAULTENABLEPROXY 169 

DEFAULTENABLESOCKS 169 

DEFAULTINTEGRATEDBROWSER 170 

DEFAULTLOADGRAPHICS 170 

DEFAULTNEWSSERVER 170 

DEFAULTPALETTEAWARE 171 

DEFAULTPARAMETERS 171 

DEFAULTPRESENTATIONMODE 172 

DEFAULTPROXYGATEWAY * 172 

DEFAULTSOCKSSERVER 172 

DEFAULTSORT 134 

DEFAULTVIEW 134, 150, 157, 195 

DEFAULTWORKINGDIR 173 

DELAY 19,57,66,97 

option of TYPEMATIC function . . . 97 

Return from CONDITION function 19 

Delete a directory 

DOSRMDIR function 77 

SysRmDir function 55 

Delete a file 

DOSDEL function 69 

SysFileDelete function . 44 

DELSTR 21 

DELWORD 21 

Deregister an object class 

SysDeregisterObjectClass function 42 

Deregister function 

REXXLIBDEREGISTER function 89 

RXFUNCDROP function 25 

SysDropFuncs function 43 

SysDropLibrary function 43 

W_Deregister function 61, 99 

DESKTOPCREATED 

SysWaitForShell function 59 

DESKTOPOPENED 

SysWaitForShell function 59 

DESKTOPPOPULATED 

SysWaitForShell function 59 

Destroy object 

SysDestroyObject function 42 

DETAB 66 
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DETACHED 

option of SysDriveMap function 43 

DETAILSCLASS 134, 196 

DETAILSFONT . 135 

DETAILSSHADOWCOLOR 135 

DETAILSTEXTCOLOR 135 

DETAILSTODISPLAY 135 

DETAILSVIEW . . . 136, 196 

Device identification 

DOSISDEV function 74 

DIGITS . . . 8, 21 

DIRECTORY 21 

Directoiy creation 

DOSMAKEDIR function 75 

DOSMKDIR function 75 

SysMkDir function . 49 

Directory existence 

DOSISDIR function . 74 

Directory removal 

DOSRMDIR function 77 

SysRmDir function 55 

Directory search 

DOSDIR function 69 

SysFileTree function 45 

Disconnect from a named pipe 

NMPIPE_DISCONNECT function 87 

DISPLAYIMAGES 168, 173 

DLL module 121 

DO , 7 

DOS / WIN-OS/2 Settings 164, 179 

DOS Settings . . 126, 180, 181 

DBTAGS.DAT 180 

DosSetting. environment variables . . 180 

Keyname-pair values 179 

DOSVDM 180 

DOS_AUTOEXEC 183 

DOS_BACKGROUND_EXECUTION .... 180, 183 

DOS BREAK 183 

DOS_DEVICE 180, 183 

DOS_FCBS 184 

DOS_FCBS_KEEP .184 

DOS_FILES 179, 180, 184 

DOS_HIGH 179, 184 

DOS LASTDRIVE 185 

DOS_RMSIZE 185 
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DOSSHELL 185 

DOS_STARTUPJDRIVE 185 

DOS_UMB 185 

DOSJVERSION . 186 

DOSAPPTYPE 66 

DOSBOOTDRIVE 38, 67 

DOSCD 67 

DOSCHDIR 67 

DOSCHMOD 67 

DOSCOMMANDFIND 67 

DOSCOPY 68, 69 

DOSCREAT 69 

DOSDEL 44, 69 

DOSDIR 69-71 

DOSDIRPOS function 71 

DOSDIRCLOSE , . . . 71 

DOSDIRPOS 71 

DOSDIR function 71 

DOSDISK 71 

DPSDRIVE 72 

DOSEALIST 72 

DOSEASIZE 72 

DOSEDITNAME 59, 72 

DOSENV 32, 73 

DOSENVLIST . . 73 

DOSENVSIZE . . . . 73 

DOSFDATE 73 

DOSFILEHANDLES 37, 56, 73 

DOSFILEINFO 74 

DOSFILESYS 45,74,79 

DOSFNAME 74 

DOSFSIZE 74 

DOSISDEV 74 

DOSISDIR 74 

DOSISFILE 74 

DOSISPIPE 75 

DOSKILLPROCESS . . 75 

DOSMAKEDIR 75 

DOSMAXPATH 75 

DOSMKDIR 49, 75 

DOSPATHFIND 56, 75 

DOSPID 75 

DOSPIDLIST 76-78 

DOSPRIORITY 57, 76 

DOSPROCINFO 76 
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DOSRENAME ; . 76 

DOSRMDIR 55,77 

DOSSESSIONTYPE 52, 77 

DosSetting. 

Used to set VDM properties 180 

DOSSWITCHLIST 77, 78 

DOSTEMPNAME 58,78 

DOSTID 78 

DOSVOLINFO 79 

DOSVOLUME 78,79 

Double-byte character set 

DBCS 9, 20 

DPMI_DOS_A3PI . . 179, 186 

DPMIMEMORYLIMIT 186 

DPMI_NETWORK_BUFF_SIZE . 187 

DRAWEROBJECTS 148 

Drive information 

DOSBOOTDRIVE function 67 

DOSDISK function 71 

DOSFILESYS function 74 

DOSVOLINFO function 79 

DOSVOLUME function , 78 

PCDISK function 88 

PCFLOPPY function 88 

SysBootDrive function 38 

SysDrivelnfo function 42 

SysDriveMap function 43 

Drive list 

SysDriveMap function . 43 

DRIVENUM 132, 196 

DROP , . 7 

ELSE 

IF instruction 8 

EMAILADDRESS 169, 174 

EMSJFRAME_LOCATION 187 

EMS_HIGH_OS_MAP_REGION . . 187 

EMS_LOW_OS_MAP_REGION 187 

EMS MEMORY LIMIT . 188 

ENABLEPROXY 169, 174 

END 

DO instruction 7, 8 

SELECT instruction 11 

ENDLOCAL 22 

ENGINEERING 
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option in NUMERIC FORM 8 

ENTAB 79 

Environment size 

DOSENVSIZE function 73 

Environment variables 

DOSENV function 73 

DOSENVLIST function 73 

DOSPATHFIND function 75 

ENDLOCAL function 22 

RXQUEUE 15 

RXTRACE . • • 15 

SET in WPProgram setup string 164 

SETLOCAL function 28 

VALUE function 32 

ERF 79 

ERFC • 79 

ERROR 

CALL instruction 7 

Return from CONDITION function 19 

Return from STREAM function 30 

SIGNAL instruction 12 

ERRORTEXT • 22 

Event semaphore 

EVENTSEM_CLOSE function 80 

EVENTSEMCREATE function 80 

EVENTSEM POST function 80 

EVENTSEMQUERY function 80 

EVENTSEM RESET function 81 

EVENTSEMWAIT function . 81 

SysCloseEventSem function 39 

SysCreateEventSem function 40 

SysOpenEventSem function 50 

SysPostEventSem function 52 

SysResetEventSem function 54 

SysWaitEventSem function 58 

EVENTSEMCLOSE 80 

EVENTSEM CREATE . . . 80 

E VENTSEM P OST . V 80 

EVENTSEMQUERY 80 

EVENTSEMRESET 81 

EVENTSEMWAIT 80,81 

EXENAME 161, 194-196 

EXISTS option 

STREAM function 30 

EXIT 7, 11 
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EXP 81 

Exponential notation 3 

EXPOSE 

PROCEDURE instruction .. 10 

Expressions 4, 11, 13, 63 

Extended attributes 

DOSEALIST function 72 

DOSEASIZE function 72 

SysGetEA function 47 

SysPutEA function 52 

SysQueryEAList function 53 

FAILURE 

CALL instruction 7 

Return from CONDITION function . 19 

SIGNAL instruction 12 

FAT file system identification 

DOSFILESYS function 74 

SysFileSystemType function 45 

File attributes 

DOSCHMOD function . . . 67 

DOSDIR function 69 

SysFileTree function 45 

File date and time 

DOSDIR function 69 

DOSFDATE function . . . 73 

DOSFILEINFO function 74 

STREAM function ; 30 

File date and time - last accessed 

DOSFILEINFO function 74 

File deletion 

DOSDEL function 69 

SysFileDelete function 44 

File existence 

DOSDIR function v. . ■ 69 

DOSISFILE function 74 

SysFileSearch function 44 

SysFileTree function 45 

File handles 

DOSFILEHANDLES 73 

SysAddFileHandle 37 

SysSetFileHandle function 56 

File name, fully qualified 

DOSCOMMANDFIND function 67 

DOSFNAME function 74 

©1993-1997 by C F S Nevada, Inc. 240 Rev 4.0 



Index 



DOSPATHFIND function 75 

SysFileTree function 45 

SysSearchPath function 56 

File name, unique 

DOSTEMPNAME function 78 

SysTempFileName function 58 

File searching 

DOSDIR function , . . /■ 69 

DOSDIRPOS function 71 

SysFileSearch function 44 

File size, actual 

DOSDIR function 69 

DOSFSIZE function 74 

File size, allocated 

DOSFILEINFO function 74 

File size, set to 0 

DOSCREAT function 69 

File system 

DOSFILESYS function 74 

SysFileSystemType function s ,-- ... 45 

FILECRC 81 

FILEREAD . 63, 81 

FILESEARCH 82 

FILESPEC 22, 45, 46, 88 

FILETRANSFERTYPE 145 

FILEWRITE . 83 

Floating point notation 3 

FONTS 141, 143, 196 

FOR 

option of DO instruction .7 

FOREVER 

option of DO instruction . . . . 7 

FORM 22 

FORMAT 22 

FPOBJECTS . 148 

FREE 

option of SysDriveMap function 43 

ftp.cfsrexx.com/pub 

C F S Nevada, Inc. FTP site 1 

FtpAppend 201 

FtpChDir 201 

FtpDelete 201 

FtpDir 201 

FtpDropFuncs 202 

FTPERRNO 
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Special variable for RxFTP 200 

FtpGet 203 

FtpLoadFuncs • ♦ • • 203 

FtpLogoff 203 

FtpLs 203 

FtpMkDir • 204 

FtpPing 204 

FtpProxy 204 

FtpPut 205 

FtpPutUnique 205 

FtpPwd 206 

FtpQuote . 206 

FtpRename 206 

FtpRmDir 206 

FtpSetBinary 206 

FtpSetUser 207 

FtpSite 207 

FtpSys 207 

Ftp Version • • 208 

Function calls 4 

Function deregistration 

FtpDropFuncs function 202 

REXXLIBDEREGISTER function . . 89 

RXFUNCDROP function 25 

SysDropFuncs function 43 

SysDropLibrary function 43 

WJDeregister function 61, 99 

Function registration 

FtpLoadFuncs function 203 

REXXLIBREGISTER function 89 

RXFUNCADD function 25 

SysLoadFuncs function 48 

SysLoadLibrary function 48 

W_Register function ...... 61, 99 

Function, interrogate availability 

RXFUNCQUERY function , ... 26 

FUZZ . 8, 23, 219, 220 

GAMMA 83 

GREP * 3 

HALT 

CALL instruction 7 

Return from CONDITION function 19 

SIGNAL instruction 12 
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Hardware functions 

PCCOPROCESSOR 88 

PCDISK 88 

PCFLOPPY 88 

PCMODEL . . 88 

PCPARALLEL 88 

PCRAM 88 

PCSERIAL 88 

PCSUBMODEL 88 

HELPLIBRARY 150 

HELPPANEL . 150, 195 

Hexadecimal notation . . . 2 

Hexadecimal to binary 

X2B function 34 

Hexadecimal to character 

X2C function 34 

Hexadecimal to decimal 

X2D function . 34 

HIDEBUTTON . 150, 151, 195 

High-frequency timer 

SysElapsedTime function 44 

HOSTNAME 144 

HPFS file system identification 

DOSFILESYS function 74 

SysFileSystemType function . 45 

HW_NOSOUND 188 

HW_ROM_TO_RAM 188 

HW TIMER 188 

I/O instructions & functions 

CHARIN 18 

CHAROUT 18 

CHARS 19 

CURSOR . ........ 65 

CURSORTYPE 65 

CVREAD 65 

CVWRITE 66 

DOSCD 67 

DOSCHDIR .67 

DOSCHMOD 67 

DOSCOPY 68 

DOSCREAT 69 

DOSDEL .69 

DOSDIR 69 

DOSDIRCLOSE 71 
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DOSDIRPOS 71 

DOSDISK 71 

DOSDRIVE 72 

DOSFDATE 73 

DOSFILEHANDLES 73 

DOSFILEINFO 74 

DOSFILESYS 74 

DOSFNAME 74 

DOSFSIZE 74 

DOSISDEV 74 

DOSISDIR 74 

DOSISFILE : 74 

DOSISPIPE . . . . 75 

DOSMKDIR 75 

DOSPATHFIND . 75 

DOSRENAME 76 

DOSRMDIR . 77 

DOSVOLINFO 79 

DOSVOLUME 78 

FILECRC . . 81 

FILEREAD 81 

FILESEARCH 82 

FILEWRITE 83 

INKEY . . ... 83 

LINEIN . 23 

LINEOUT 24 

LINES 24 

NMPIPE READ . . . 87 

PARSE LINEIN 9 

PARSE PULL .9 

PCVIDEOMODE 89 

PMPRINTF 89 

PULL 10 

QUEUED 25 

RxMessageBox 26 

SAY 11 

SCRBLINK 92 

SCRBORDER. 92 

SCRCLEAR 92 

SCROLLDOWN . 93 

SCROLLLEFT 93 

SCROLLRIGHT 94 

SCROLLUP . . . 94 

SCRPUT 94 

SCRREAD 94 
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SHIFTSTATE 95 

STREAM 29 

STRINGIN 96 

SysAddFileHandle 37 

SysCls 39 

SysCurPos 42 

SysCurState 42 

SysDrivelnfo 42 

SysDriveMap . . f 43 

SysFileDelete . . . . 44 

SysFileSearch 44 

SysFileTree 45 

SysGetEA 47 

SysGetKey . . . 47 

SysMkDir . 49 

SysPutEA 52 

SysRmDir 55 

SysSearchPath 56 

SysSetFileHandle 56 

SysTempFileName 58 

SysTextScreenRead 58 

SysTextScreenSize 58 

TYPEMATIC 97 

VARDUMP 98 

VARREAD 98 

VARWRITE 98 

W ATTR 99 

WBORDER 99 

W_CLEAR 99 

W_CLOSE 100 

WFIELD 100 

WGET 100 

WJHIDE 101 

W_KEYS 102 

W_MOVE 103 

W_OPEN 103 

W_PUT 103 

W READ 104 

W_SCRPUT 105 

W_SCRREAD 105 

W_SCRWRITE 106 

W_SIZE 106 

W UNFIELD 106 

W_UNHIDE 106 

Icon manipulation 
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SysSetlcon function 56 

ICONFILE 136, 138, 151 

ICONFONT 136, 196 

ICONGRIDSIZE . . 136 

ICONNFILE 137, 196 

ICONNRESOURCE 137 

ICONPOS 137, 151 

ICONRESOURCE ... 138, 151 

ICONSHADOWCOLOR 138 

ICONTEXTBACKGROUNDCOLOR 138 

ICONTEXTCOLOR . 138 

ICONTEXTVISIBLE , 138 

ICONVIEW 139, 196 

ICONVIEWPOS ... 139 

IDLE_SECONDS 188 

IDLE_SENSITIVITY 188, 189, 191 

IF 8 

INFINITY 

Returned by LOG function 84 

Returned by LOG10 function 84 

INKEY 47,83 

Table of return values 211 

INSERT 23, 162, 163, 211 

INSTPATH 156 

INT_DURING_IO 189 

INTEGRATEDBROWSER . 170, 174 

Interactive debugging 

TRACE instruction 13 

Interprocess Communication Functions 

EVENTSEM CLOSE 80 

EVENTSEM CREATE 80 

EVENTSEMPOST 80 

EVENTSEMQUERY 80 

EVENTSEM RESET 81 

EVENTSEM WAIT 81 

MUTEXSEM_CLOSE 85 

MUTEXSEM CREATE 85 

MUTEXSEMQUERY 85 

MUTEXSEM RELEASE 86 

MUTEXSEM REQUEST 86 

SysCloseEventSem 39 

SysCloseMutexSem . • • • • 39 

SysCreateEventSem 40 

SysCreateMutexSem , 40 

SysOpenEventSem 50 
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SysOpenMutexSem 50 

SysPostEventSem 52 

SysReleaseMutexSem . . . 54 

SysRequestMutexSem 54 

SysResetEventSem 54 

SysWaitEventSem 58 

SysWaitForShell 59 

Interrogate function's availability 

RXFUNCQUERY function 26 

ITERATE 8,218,220 

JOBDIALOGBEFOREPRINT 158, 195 

JOBPROPERTIES 158 

KBDALTHOMEBYPASS 189 

KBD_BUFFERJEXTEND . 189 

KBDCTRLBYPASS 189 

KBDR ATELO CK 190 

Keyboard input 

INKEY function 83 

SHIFTSTATE . . 95 

STRINGIN function 96 

SysGetKey function 47 

W GET function 100 

WJCEYS function 102 

W READ function 104 

W_SCRREAD function 105 

KeyRepeatDelay 147 

KeyRepeatRate 147 

Keyword Instructions 6 

Labels 3, 13 

Call 3 

Signal 3 

LAN file system identification 

DOSFILESYS function 74 

SysFileSystemType function 45 

LASTPOS : 23 

LaunchPad 

see WPLaunchPad 148 

LEFT 23 

LENGTH 23 

LINEIN 9, 23, 37, 73 

option of PARSE instruction 9 

LINEOUT 24, 37, 73 
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LINES 24 

LIT 

Return from SYMBOL function 31 

Literal strings . 2, 4 

LOADGRAPHICS 170, 175 

LOCAL 

option of SysDriveMap function 43 

LOCALDIR 146 

LOCATOR 176, 178 

LOCKEDINPLACE 151 

LOCKUP AUTODIM 129 

LOCKUPBACKGROUND 130, 131 

LOCKUPFULLSCREEN 131 

LOCKUPONSTARTUP 131 

LOCKUPSCREENSAVERMODE 131 

LOCKUPTIMEOUT 131 

LOG 84, 110, 113 

LOG10 84 

LOWER 84 

LOWERCASE 20, 84 

DATATYPE function 20 

LPACTIONSTYLE 148 

LPCLOSEDRAWER 149 

LPDRAWERTEXT 149 

LPFLOAT 149 

LPHIDECTLS 149 

LPSMALLICONS 149 

LPTEXT 149 

LP VERTICAL 149 

MACROADD 84,90, 92 

MACROCLEAR 84 

MACRODROP 84 

MACROLOAD 84, 90, 92 

MACROQUERY 85 

MACROREORDER 85 

MACROSAVE - 85 

Macrospace 

MACROADD function 84 

MACROCLEAR function 84 

MACRODROP function 84 

MACROLOAD function 84 

MACROQUERY function 85 

MACROREORDER function 85 

MACROSAVE function 85 
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SysAddRexxMacro function 38 

SysClearRexxMacroSpace function 38 

SysDropRexxMacro function . 43 

SysLoadRexxMacroSpace function . . . 49 

SysQueryRexxMacro function 53 

SysReorderRexxMacro function 54 

SysSaveRexxMacroSpace function 55 

Macrospace return codes 228 

MATCH 

option of VERIFY function 33 

Math coprocessor check 

PCCOPROCESSOR function 88 

Math functions 

ACOS 62 

ASIN .64 

ATAN 64 

ATAN2 64 

COS 65 

COSH 65 

ERF 79 

ERFC 79 

EXP 81 

GAMMA 83 

LOG 84 

LOG10 84 

MAX .24 

MIN . 24 

POW 89 

RANDOM 25 

SIN 95 

SINH 95 

SORT 95 

TAN 96 

TANH 96 

MAX . . . 24, 25, 86, 87 

MAXIMIZED 161, 195, 196 

MEMJEXCLUDE_REGIONS 190 

MEMINCLUDEREGIONS 190 

MENUBAR 140 

MENUITEMSELECTED . . 152 

MENUS . . 152 

Messages 

SysGetMessage function 47 

MIN 24, 25 

MINIMIZED 120, 152, 161, 195, 196 
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MINWIN 152, 195 

MOUSE_EXCLUSIVE_ACCESS 190 

Mutex semaphore 

MUTEXSEMJXOSE function 85 

MUTEXSEM_CREATE function 85 

MUTEXSEM_QUERY function 85 

MUTEXSEM RELEASE function 86 

MUTEXSEMREQUEST function 86 

SysCloseMutexSem function 39 

SysCreateMutexSem Function 40 

SysOpenMutexSern function 50 

SysReleaseMutexSem function 54 

SysRequestMutexSerh function .54 

MUTEXSEM_CLOSE 85 

MUTEXSEM CREATE 85 

MUTEXSEM QUERY 85 

MUTEXSEM_RELEASE 86 

MUTEXSEM REQUEST 86 

NAME 

option of CALL instruction 7 

option of SIGNAL instruction 12 

Named pipe 

DOSISFILE function 74 

DOSISPIPE function 75 

NMPIPE_CALL function 86 

NMPIPEJXOSE function 86 

NMPIPE_CONNECT function 86 

NMPIPECREATE function 86 

NMPIPE_DISCONNECT function 87 

NMPIPE_OPEN function 87 

NMPIPEJREAD function 87 

NMPIPETRANSACT function 87 

NMPIPE_WRITE function 87 

SysWaitNamedPipe function 59 

Named pipe transaction 

NMPIPE CALL function 86 

NAN 

Returned by ACOS function 62 

Returned by ASIN function 64 

Returned by AT AN function 64 

Returned by ATAN2 function 64 

Returned by POW function 89 

Returned by SQRT function 95 

NETID . 165, 195, 196 
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NETWAREJRESOURCES . 190 

NEWSERVER 171, 176 

NMPIPE_CALL 86 

NMPIPE_CLOSE 86 

NMPIPE_CONNECT 86 

NMPIPE_CREATE . . . 86 

NMPIPEJDISCONNECT 87 

NMPIPE_OPEN . . 87 

NMPIPEREAD 87 

NMPIPETRANSACT 87 

NMPIPE_WRITE .87 

NOAUTOCLOSE 161, 162, 195, 196 

NOCOPY 152, 195 

NODELETE 152, 195 

NODRAG 152, 195 

NODROP 153, 195 

NOLINK 153, 195 

NOMATCH 

option of VERIFY function 33 

NOMOVE 153, 195 

NOP . 8, 218 

NOPRINT 153, 195 

NORENAME 153, 195 

NOSETTINGS 153, 195 

NOSHADOW 154, 195 

NOTREADY 

CALL instruction 7 

Return from CONDITION function 19 

Return from STREAM function 30 

SIGNAL instruction 12 

NOTREADY condition 

CHARIN function 18 

CHAROUT function 18 

CHARS function 19 

LINEIN function 23 

LINEOUT function 24 

LINES function 24 

NOTVISIBLE ■ . . 154, 195 

NOVALUE 

Return from CONDITION function 19 

SIGNAL instruction 12 

Numbers 3 

NUMERIC DIGITS 8, 21 

NUMERIC FORM 8,22 

NUMERIC FUZZ 8, 23 
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Object alteration 

SysSetObjectData function 56 

Object class deregistration 

SysDeregisterObjectClass function 42 

Object class query 

SysQueryClassList function . 53 

Object class registration 

SysRegisterObjectClass function 53 

Object copy 

SysCopyObject 39 

Object creation 

SysCreateObject function 40 

Object destruction 

SysDestroyObject function 42 

Object ID 

WPS Objects 107 

Object move 

SysMoveObject function 49 

Object open 

SysOpenObject function 51 

Object save 

SysSaveObject function 55 

Object shadowing 

SysCreateShadow function 41 

OBJECTED 39, 154, 155, 195 

Conflict with TEMPLATE setting 154, 155 



OFF 



option of CALL instruction 

option of SIGNAL instruction .... 
option of SysCurState function . . . 
Return from CONDITION function 



. 7 
12 
42 
19 



ON 



option of CALL instruction 

option of SIGNAL instruction .... 
option of SysCurState function . . . 
Return from CONDITION function 



. 7 
12 
42 
19 



OPEN 

WPFolder object 
WPProgram object 



140, 154 
... 162 



Open a named pipe 

NMPIPE_OPEN function 



87 



OPEN option 

STREAM function 



29 
. 3 
. 9 



Operators and their precedence 



OPTIONS 
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OS/2 version information 

SysOS2Ver function 52 

OS2ENVIRONMENT 

DOSENV function 73 

DOSENVLIST function 73 

DOSENVSIZE function 73 

VALUE function 32 

Other Rexx External Function Modules 60 

OTHERWISE 

SELECT instruction 11 

OUTPUTTOFILE 158, 195 

OVERLAY 24 

PALETTEAWARE 171, 176 

PARAMETERS 162 

PARSE 9, 10 

Example of SysFileTree() stem 45 

PARSEFN 22, 87 

Path search 

DOSDIR function 69 

DOSPATHFIND function 75 

SysAddRexxMacro function 38 

SysSearchPath function 56 

Path size 75 

DOSMAXPATH function 75 

PCCOPROCESSOR 88 

PCDISK 88 

PCFLOPPY 88 

PCMODEL 88 

PCPARALLEL 88 

PCRAM • 88 

PCSERIAL 88 

PCSUBMODEL 88 

PCVIDEOMODE 89 

PMPRINT 160 

PMPRINTF 89 

PMREXX 22, 26, 27, 32, 37 

PopUpMenu 147, 152 

PORTNAME . . , 156-158, 195 

POS 24 }/ 82, 83 

Post event semaphore 

EVENTSEM POST function 80 

SysPostEventSem function 52 

POW 89 

Power 
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Exponentiate 3 

PRESENT ATIONMODE 172, 177 

PRINTSEPARATEOUTPUT 191 

PRINTTIMEOUT . 191 

PRINTDRIVER 156, 159, 195 

Printer 

Notebook setting equivalent 157 

PRINTERSPECIFICFORMAT 159, 195 

PRINTWHILESPOOLING 159, 195 

Priority 

DOSPRIORITY function 76 

SysSetPriority function . . .■ 57 

PROCEDURE 10 

Process count 

DOSPIDLIST function .76 

DOSSWITCHLIST function 77 

SysQuerySwitchList function 53 

Process id 

DOSPID function 75 

Process information 

DOSPROCINFO function 76 

Process termination 

DOSKILLPROCESS function 75 

PROGTYPE 163, 194-196 

PROMPT 13, 157, 163 

PROXYGATEWAY 172, 177 

PULL • 9, 10 

option of PARSE instruction 9 

PUSH 10, 168-173 

QSTARTTIME 159, 195 

QSTOPTIME . 159, 196 

Query class list 

SysQueryClassList function 53 

Query event semaphore 

EVENTSEM^QUERY function 80 

Query mutual exclusion semaphore 

MUTEXSEM_QUERY function 85 

QUERY option 

STREAM function 30 

QUEUE 10 

QUEUED 25,226 

QUEUEDRIVER 160, 196 

QUEUENAME 160, 196 
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RANDOM 25 

RC special variable 6 

Read from a named pipe 

NMPIPEREAD function 87 

READ option 

STREAM function 29 

READY 

Return from STREAM function 29, 30 

REFRESHINTERVAL 165 

Register a function 

REXXLIBREGISTER function 89 

RXFUNCADD function 25 

WJRegister function 61, 99 

Release ownership of mutual exclusion semaphore 

MUTEXSEM_RELEASE function 86 

SysReleaseMutexSem function 54 

REMOTE 

option of SysDriveMap function 43 

REMOTEDIR 145 

REMOVEFONTS 141 

Rename a file or directory 

DOSRENAME function 76 

Request ownership of mutual exclusion semaphore 

MUTEXSEM_REQUEST function . . . 86 

SysRequestMutexSem function 54 

Reset event semaphore - 

EVENTSEM_RESET function 81 

SysResetEventSem function 54 

RESULT special variable 4, 6, 11 

RETURN 6, 10 

REVERSE 25 

REXX data queue 

PARSE instruction 9 

PULL instruction 10 

PUSH instruction 10 

QUEUE instruction ' . . . 10 

QUEUED function 25 

RXQUEUE function ^27 

RxQueue subcommand 14 

REXX Error Codes 

Appendix D 215 

REXX External Function Modules 36, 60 

REXXLIB Functions 60, 62, 89 

REXXLIBDEREGISTER 61,89 

REXXLIBREGISTER . 61, 89 
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REXXLIBVER 89 

REXXRUN 90, 91, 97 

REXXTHREAD 91^97 

REXXUTIL Functions '36 

REXXUTIL, drop all functions 

SysDropFuncs function 43 

RGB values 128 

RIGHT 25 

RXFUNCDROP 25 

RXFUNCQUERY .26 

RXMESSAGEBOX 26 

RXQUEUE 

Environment variables 15 

function 27 

subcommand . . . 14 

RXSUBCOM 15,225-227 

RXTRACE 15, 16 

SAY 11,47 

SBCS 

Single-byte character set 20 

Scan subdirectories 

option of DOSDIR function 69 

option of SysFileTree function 46 

SCIENTIFIC 

option in NUMERIC FORM .8 

SCRBLINK . . 92,214 

SCRBORDER . . . 92 

SCRCLEAR \..\ 39, 92, 99 

Screen read 

CHARIN function 18 

CURSOR function 65 

SCRREAD function 94 

STRINGIN function 96 

SysCurPos function 42 

SysTextScreenRead function 58 

WJ3ET function . 100 

W_READ function 104 

W SCRREAD function 105 

Screen resolution 

PCVIDEOMODE function 89 

Screen size 

SCRSIZE function 94 

SysTextScreenSize function . 58 

Screen text manipulation functions 

©1993-1997 by C F S Nevada, Inc. 256 Rev 4.0 



Index 



SCRBORDER 92 

SCRCLEAR 92 

SCROLLDOWN 93 

SCROLLLEFT 93 

SCROLLRIGHT 94 

SCROLLUP 94 

SCRPUT 94 

SCRREAD 94 

SCRSIZE .94 

SCRWRITE 95 

SysCls 39 

SysCurPos 42 

SysCurState 42 

SysGetKey . . 47 

SysTextScreenRead 58 

SysTextScreenSize 58 

W ATTR 99 

WJFTELD 100 

WGET 100 

W_HIDE . . 101 

W_MOVE 103 

W_OPEN 103 

W_PUT 103 

W READ 104 

W_SCRPUT 105 

WSCRREAD 105 

W_SCRWRITE 106 

WUNFIELD , 106 

W_UNHIDE 106 

Screen write 

CHAROUT function 18 

LINEOUT function , . 24 

SAY instruction 11 

SCRCLEAR function 92 

SCRPUT function 94 

SCRWRITE function 95 

SysCls function 39 

W_ATTR function 99 

W_BORDER function 99 

W CLEAR function 99 

W_MOVE function 103 

W_OPEN function 103 

W_PUT function 103 

W_SCRPUT function 105 

W_SCRWRITE function 106 
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W_UNHIDE function 106 

SCROLLDOWN 93 

SCROLLLEFT 93 

SCROLLRIGHT .94 

SCROLLUP 94 

SCRPUT 94, 105 

SCRREAD 94, 105, 106 

SCRSIZE . 58, 94, 103, 106 

SCRWRITE . 95, 106 

Search a file 

FILESEARCH function . . 82 

SysFileSearch function 44 

Search for directories 

option of DOSDIR function 69 

option of SysFileTree function 46 

Search for files 

option of DOSDIR function 69 

option of SysFileTree function 46 

SEEK option 

STREAM function .29 

SELECT 11 

Semaphore functions 

EVENTSEM CLOSE 80 

EVENTSEMCREATE 80 

E VENTSEMP OST 80 

EVENTSEM QUERY . 80 

EVENTSEM RESET 81 

EVENTSEM_WAIT ... 81 

MUTEXSEM_CLOSE 85 

MUTEXSEM CREATE v. 85 

MUTEXSEMQUERY 85 

MUTEXSEM RELEASE 86 

MUTEXSEM REQUEST . 86 

SysCloseEventSemaphore . . . . 39 

SysCloseMutexSem . 39 

SysCreateEventSem . . . 40 

SysCreateMutexSem ..40 

SysOpenEventSem • 50 

SysOpenMutexSem • 50 

SysPostEventSem 52 

SysReleaseMutexSem 54 

SysRequestMutexSem . 54 

SysResetEventSem 54 

SysWaitEventSem 58 

SEPARATORFILE . . . 160, 196 
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Session information 

DOSSESSIONTYPE function 77 

SysProcessType function 52 

SESSION JPRIORITY 191 

SET 

WPProgram environment variable 164 

SETLOCAL 22, 28 

SHADOWID 155, 195 

SHIFTSTATE 95 

SHOWALLINTREEVIEW 141 

SHOWJOBS 165 

SIGL 

Special variable 6, 12 

SIGN 28, 163 

SIGNAL 11 

Return from CONDITION function 19 

SIN 95 

Single-byte character set 

SBCS 20 

SINH .95 

SIO_ 126, 183, 191 

SIO_Allow_Access_COMn 191 

SIO_Idle_Sensitivity 191 

SIO__Mode_DataBits 191 

SIO_Mode_DTR 191 

SIO_Mode_FIFO_Ix>ad_Count 191 

SIO_Mode_IDSR 191 

SIO__Mode_OCTS 191 

SIO_Mode_ODSR 191 

SIO_Mode_Parity 192 

SIO_Mode_RTS , 191 

SIO_Mode_StopBits 191 

SIO_Mode_XON/XOFF 191 

SIO_Screen_SyncJK;iudge 191 

SIO_Share_Access_With_OS/2 191 

SIO_Virtual_DTR_is_HS 191 

SIO_Virtual__RTS_is_HS 191 

SIO_Virtualize_16550A 191 

SIO_Virtualize_COM^Ports 192 

SIZE option 

STREAM function 30 

SOCKSERVER 173, 178 

Sort order 

Always maintain sort order setting 132 

SORTBYATTR 141 
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SORTCLASS 141, 196 

SOUND • 17, 95, 111, 120 

SOURCE 

option of PARSE instruction 9 

SOURCELINE .28 

SPACE . . 28 

Special variables 

_ACTIVATION_FIELD 104 

_ACTIVATION_KEY . . 104 

ACTIVATIONKEYNAME . . 101, 104 

FTPERRNO 200 

RC 6 

RESULT .... 4, 11 

SIGL 6, 12 

SQRT 95 

STARTUP.CMD 

Registering External Functions 37 

STARTUPDIR 165, 195, 196 

STDERR 13, 15 

trace output from SAA REXX 13 

STDIN 14, 19 

STDOUT 11, 15, 98 

Stem 

portion of compound variables 3 

STREAM 29 

STRINGCRC 95 

STRINGIN 96 

STRIP 31, 45, 47, 202 

Substitution characters 

Used in PARAMETERS setting 162 

SUBSTR 31 

SUBWORD 31 

SYMBOL 31 

VALUE function 32 

Symbols ..... 2 

SYNCJOBPROP 160 

SYNCPRINTERPROP 160 

SYNTAX 

Return from CONDITION function 19 

SIGNAL instruction 12 

SysAddFileHandle . . 37, 73 

SysAddRexxMacro 38 

SysBootDrive 38 

SysClearRexxMacroSpace 38 

SysCloseEventSem 39, 40 
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SysCls 39,92 

SysCopyObject 39 

SysCreateEventSem 39, 40, 50, 52, 54 

SysCreateMutexSem 39,40,50,54 

SysCreateObject 40 

SysCreateShadow 41 

SysCurPos 42, 65 

SysCurState 42 

SysDeregisterObjectClass 42 

SysDestroyObject 42 

SysDrivelnfo 42 

SysDriveMap 43 

SysDropFuncs 43 

SysDropLibrary 43 

SysDropRexxMacro . 43 

SysElapsedTime 43, 44 

SysFileDelete 44, 69 

SysFileSearch 44 

SysFileSystemType 45, 74 

SysFileTree 30,45 

SysGetCollate 47 

SysGetEA 47 

SysGetKey 47,83,211-213 

Table of return values 211 

SysGetMessage 38, 47, 73 

Syslni 47, 48, 121 

SysLoadFuncs 37, 48 

SysLoadLibrary 48 

SysLoadRexxMacroSpace 49 

SysMapCase 49 

SysMkDir 49, 75 

SysMoveObject '. . 49 

SysNationalLanguageCompare 50 

SysOpenEventSem 40, 50 

SysOpenMutexSem • 40, 50 

SysOpenObject 51 

SysOS2Ver 52 

SysPostEventSem 40, 52 

SysPutEA 52 

SysQueryClassList 53 

SysQueryEAList 53 

SysQueryProcessCodePage 53 

SysQueryRexxMacro 53 

SysQuerySwitchList 53, 58 
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SysRegisterObjectClass 53 

SysReleaseMutexSem 40, 54 

SysReorderRexxMacro 54 

SysRequestMutexSem 40, 54 

SysResetEventSem 40, 54 

SysRmDir 55' 77 

SysSaveObject 55 

SysSaveRexxMacroSpace 55 

SysSearchPath 56, 75 

SysSetFileHandle '56 

SysSetlcon 55 

SysSetObjectData 56 

SysSetPriority si ,16 

SysSetProcessCodePage 57 

SysShutDownSystem 57 

SysSleep si } 66 

SysSwitchSession 58 

System (BIOS) model number 

PCMODEL function 88 

System (BIOS) submodel number 

PCSUBMODEL function 88 

System Commands & Subcommand Environments 14 

SysTempFileName 58, 78 

SysTextScreenRead 58 

SysTextScreenSize . 58, 94, 103, 106 

SysWaitEventSem 40, 58 

SysWaitForShell '59 

SysWaitNamedPipe 59 

SysWildCard ,59 

Tab characters 

DETAB function 66 

ENTAB function 79 

Tail 

portion of compound variables 3 

TAKEDEFAULTS 160 166 

TAN \ 96 

TANH 96 

TEMPLATE 155 

Conflict with OBJECTID setting . . 154 

Templates 5, 108, 111, 112, 116, 120, 219 

THEN 

IF instruction .8 

SELECT instruction 11 

Tilde character 
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Object REXX message send character 4 

TIME 31 

Time replacement 

DOSFDATE function . 73 

TITLE 155 

WPS Objects 107 

TO 

option of DO instruction 7 

TOKENIZEFILE 90, 92, 96 

TOKENIZESTRING 90, 92, 97 

TOUCHEXCLUSIVE_ACCESS . . . . 192 

TRACE 

function . . . . 32 

instruction 13 

output . . . 13 

RXTRACE environment variable 15 

TRANSLATE . 32 

TREEFONT . . 141, 196 

TREESHADOWCOLOR 141 

TREETEXTCOLOR 142 

TREETEXTVISIBLE 142 

TREEVIEW 142, 196 

TRUNC 32 

Type of executable file 

DOSAPPTYPE function 66 

TYPEMATIC . 61, 97 

UNKNOWN 

Return from STREAM function 30 

UNTIL 

option of DO instruction 7 

UPPER 97 

Uppercase 

ARG instruction 6 

DATATYPE function 20 

option of PARSE instruction 9 

PULL instruction 10 

SysNationalLanguageCompare function 50 

TRANSLATE function 32 

URL 109, 116, 167479 

USED 

option of SysDriveMap function 43 

USER 

option of Syslni function 48 

USERNAME 144, 146 
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VALIDNAME 98 

VALUE 32 

ADDRESS instruction . 6 

NUMERIC FORM instruction . . 8 

option of PARSE instruction 9 

PARSE instruction 9 

SIGNAL instruction 11 

TRACE instruction 13 

VAR 

option of PARSE instruction 9 

Return from SYMBOL function 31 

VARDUMP 98 

Variables 3 

VARREAD 98 

VARWRITE 98 

Version information 

REXXLIBVER function 89 

SysOS2Ver function 52 

Version option of PARSE instruction ; 10 

Video 

PCVIDEOMODE function . 89 

SCRBLINK function 92 

SCRBORDER function 92 

SCRCLEAR function 92 

SCROLLDOWN function 93 

SCROLLLEFT function 93 

SCROLLRIGHT function .94 

SCROLLUP function 94 

SCRPUT 94 

SCRREAD function 94 

SCRSIZE function 94 

SCRWRITE function . 95 

Video attributes 

Appendix C 214 

SCRBLINK function 92 

SCRBORDER function 92 

SCRCLEAR function 92 

SCROLLDOWN function 93 

SCROLLLEFT function 93 

SCROLLRIGHT function . 94 

SCROLLUP function 94 

SCRPUT function 94 

SCRREAD function 94 

SCRWRITE function 95 

STRINGIN function . 96 
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WATTR function 99 

W BORDER function ; . . 99 

WCLEAR function 99 

WFIELD function 100 

WJ3ET function 100 

W^OPEN function 103 

WJPUT function 103 

WJSCRWRITE function 106 

VIDEO_8514A_XGAJOTRAP 192 

VIDEO_FASTPASTE 192 

VIDEO_MODE_RESTRICTION 192 

VIDEO_ONDEMAND_MEMORY 192 

VIDEORETRACEEMULATION 192 

VIDEOROMEMULATION 193 

VIDEO_SWITCH_NOTIFICATION 193 

VIDEO_WlNDOW_REFRESH 193 

Volume label 

DOSVOLUME 78 

SysDrivelnfo function 42 

WATTR 99 

\VBORDER 99 

W_CLEAR 99 

\VCLOSE 100, 106 

W FIELD 100, 102, 106 

WGET 100, 102, 104 

WJHDE 101, 106 

WJSFIELD 101 

WJSWINDOW 101 

W_KEYS 102 

W_MOVE 103 

W_OPEN 99-106 

W_PUT 103, 104 

WJREAD 102, 104 

WJSCRPUT 105 

WSCRREAD 105, 106 

W_SCRWRITE 106 

W_SIZE 106 

WJJNFIELD 106 

W_UNHIDE 106 

Wait 

EVENTSEM WAIT function . 81 

INKEY function 83 

MUTEXSEM REQUEST function 86 

NMPIPE_CALL function 86 
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RXQUEUE function 27 

SysGetKey function 47 

SysSleep function 57 

SysWaitEventSem function 58 

SysWaitForShell function * 59 

SysWaitNamedPipe function . 59 

Warp 1 

WHEN 

SELECT instruction . 11 

WHILE 

option of DO instruction . ." .... 7 

WIN_ATM 193 

WIN_CLIPBOARD 193 

WINDDE 194 

WIN_RUN_MODE 194 

Windows sessions only 

Key name - pair values 193 

WINOS2 126, 156, 157 

WIN0S2 Settings 

Keyname-pair values 179 

WITH 

option of PARSE instruction 9 

WORD . 33 

WORDINDEX 33 

WORDLENGTH 33 

WORDPOS 33 

WORDS 33 

Work Place Shell 

see WPS objects 107 

WORKAREA 143, 196 

WORKINGDIR 173, 179 

World Wide Web 

http://www.cfsrexx.com . 2 

WPDesktop 

Key name - value pairs 129 

WPDisk 

Key name - value pairs 132 

WPFolder 

Key name - value pairs 132 

WPLaunchPad 

Key name - value pairs 148 

WPObject 

Key name - value pairs 150 

WPPrinter 

Key name - value pairs 157 
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.VPProgram 

Key name - value pairs 161 

vVPS class names l 2i 

MPS Classes 42, 121-124 

WPS Objects 10 7 > 126 

Classes for Warp 3 I 23 

Classes for Warp 4 I 24 

Classes prior to Warp 3 1 2 1 

Object ID 1° 7 

SysCopyObject function . . 39 

SysCreateObject function 40 

SysCreateShadow function 41 

SysDeregisterObjectClass function 42 

SysDestroyObject 42 

SysMoveObject function 49 

SysOpenObject function 51 

SysQueryClassList function 53 

SysRegisterObjectClass function 53 

SysSaveObject function 55 

SysSetObjectData function 56 

WPTools 195, 197, 198 

WPToolsFolderContent 197 

WPToolsQueryObject 195-197 

WRITE option 

STREAM function . . 29 

Write to a named pipe 

NMPIPEJWRITE function 87 

X2B * 34 

X2C 34 

X2D 34 

XCELLCOUNT 128, 143, 155, 166, 196 

XCELLGAP 156, 196 

XCELLHEIGHT 196 

XCELLWIDTH 155, 196 

XMS_HANDLES 193 

XMSJMEMORYJJMIT 193 

XMS_MINIMUM_HMA 193 

XRANGE 33 

YCELLCOUNT 1 2 9, 143, 155, 167, 196 

YCELLGAP 156, 196 

YCELLHEIGHT 155 
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CPS Nevada, Inc. 

953 E. Sahara Avenue, Suite 9B 
Las Vegas, Nevada 89104-3012 
702-732-9616 Voice 
702-732-3847 FAX 



Name: 

Company: 

Address: 

City, State and Zip: 

Voice / FAX number: EmaH Address 

AM EX Discover MC Visa Card#_ 

Quantity: _ @ $31 .95 + $4.00 S&H (U.S.) Total Amount: 




Order Form 

Orders only • 1-800-REXXOS2 
1-800-739-9672 
On-line • www.cfsrexx.com 



Expires: / Check # 



Signature: 



Order form on reverse 
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